<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=11"/>
<meta name="generator" content="Doxygen 1.9.4"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Flow: cfg/cfg_manager.hpp Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr id="projectrow">
  <td id="projectalign">
   <div id="projectname">Flow<span id="projectnumber">&#160;2.0.0</span>
   </div>
   <div id="projectbrief">Flow project: Full implementation reference.</div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.9.4 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
var searchBox = new SearchBox("searchBox", "search",'Search','.html');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function() {
  initMenu('',true,false,'search.php','Search');
  $(document).ready(function() { init_search(); });
});
/* @license-end */
</script>
<div id="main-nav"></div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0" 
        name="MSearchResults" id="MSearchResults">
</iframe>
</div>

<div id="nav-path" class="navpath">
  <ul>
<li class="navelem"><a class="el" href="dir_cfb2ffb2869bbb27b7281952022eb856.html">cfg</a></li>  </ul>
</div>
</div><!-- top -->
<div class="header">
  <div class="headertitle"><div class="title">cfg_manager.hpp</div></div>
</div><!--header-->
<div class="contents">
<a href="cfg__manager_8hpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a id="l00001" name="l00001"></a><span class="lineno">    1</span><span class="comment">/* Flow</span></div>
<div class="line"><a id="l00002" name="l00002"></a><span class="lineno">    2</span><span class="comment"> * Copyright 2023 Akamai Technologies, Inc.</span></div>
<div class="line"><a id="l00003" name="l00003"></a><span class="lineno">    3</span><span class="comment"> *</span></div>
<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment"> * Licensed under the Apache License, Version 2.0 (the</span></div>
<div class="line"><a id="l00005" name="l00005"></a><span class="lineno">    5</span><span class="comment"> * &quot;License&quot;); you may not use this file except in</span></div>
<div class="line"><a id="l00006" name="l00006"></a><span class="lineno">    6</span><span class="comment"> * compliance with the License.  You may obtain a copy</span></div>
<div class="line"><a id="l00007" name="l00007"></a><span class="lineno">    7</span><span class="comment"> * of the License at</span></div>
<div class="line"><a id="l00008" name="l00008"></a><span class="lineno">    8</span><span class="comment"> *</span></div>
<div class="line"><a id="l00009" name="l00009"></a><span class="lineno">    9</span><span class="comment"> *   https://www.apache.org/licenses/LICENSE-2.0</span></div>
<div class="line"><a id="l00010" name="l00010"></a><span class="lineno">   10</span><span class="comment"> *</span></div>
<div class="line"><a id="l00011" name="l00011"></a><span class="lineno">   11</span><span class="comment"> * Unless required by applicable law or agreed to in</span></div>
<div class="line"><a id="l00012" name="l00012"></a><span class="lineno">   12</span><span class="comment"> * writing, software distributed under the License is</span></div>
<div class="line"><a id="l00013" name="l00013"></a><span class="lineno">   13</span><span class="comment"> * distributed on an &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR</span></div>
<div class="line"><a id="l00014" name="l00014"></a><span class="lineno">   14</span><span class="comment"> * CONDITIONS OF ANY KIND, either express or implied.</span></div>
<div class="line"><a id="l00015" name="l00015"></a><span class="lineno">   15</span><span class="comment"> * See the License for the specific language governing</span></div>
<div class="line"><a id="l00016" name="l00016"></a><span class="lineno">   16</span><span class="comment"> * permissions and limitations under the License. */</span></div>
<div class="line"><a id="l00017" name="l00017"></a><span class="lineno">   17</span><span class="comment"></span> </div>
<div class="line"><a id="l00018" name="l00018"></a><span class="lineno">   18</span><span class="comment">/// @file</span></div>
<div class="line"><a id="l00019" name="l00019"></a><span class="lineno">   19</span><span class="comment"></span><span class="preprocessor">#pragma once</span></div>
<div class="line"><a id="l00020" name="l00020"></a><span class="lineno">   20</span> </div>
<div class="line"><a id="l00021" name="l00021"></a><span class="lineno">   21</span><span class="preprocessor">#include &quot;<a class="code" href="cfg__fwd_8hpp.html">flow/cfg/cfg_fwd.hpp</a>&quot;</span></div>
<div class="line"><a id="l00022" name="l00022"></a><span class="lineno">   22</span><span class="preprocessor">#include &quot;<a class="code" href="cfg__manager__fwd_8hpp.html">flow/cfg/cfg_manager_fwd.hpp</a>&quot;</span></div>
<div class="line"><a id="l00023" name="l00023"></a><span class="lineno">   23</span><span class="preprocessor">#include &quot;<a class="code" href="option__set_8hpp.html">flow/cfg/option_set.hpp</a>&quot;</span></div>
<div class="line"><a id="l00024" name="l00024"></a><span class="lineno">   24</span><span class="preprocessor">#include &quot;<a class="code" href="util_2util_8hpp.html">flow/util/util.hpp</a>&quot;</span></div>
<div class="line"><a id="l00025" name="l00025"></a><span class="lineno">   25</span><span class="preprocessor">#include &quot;<a class="code" href="shared__ptr__alias__holder_8hpp.html">flow/util/shared_ptr_alias_holder.hpp</a>&quot;</span></div>
<div class="line"><a id="l00026" name="l00026"></a><span class="lineno">   26</span><span class="preprocessor">#include &lt;boost/array.hpp&gt;</span></div>
<div class="line"><a id="l00027" name="l00027"></a><span class="lineno">   27</span> </div>
<div class="line"><a id="l00028" name="l00028"></a><span class="lineno">   28</span><span class="keyword">namespace </span><a class="code hl_namespace" href="namespaceflow_1_1cfg.html">flow::cfg</a></div>
<div class="line"><a id="l00029" name="l00029"></a><span class="lineno">   29</span>{</div>
<div class="line"><a id="l00030" name="l00030"></a><span class="lineno">   30</span><span class="comment">// Types.</span></div>
<div class="line"><a id="l00031" name="l00031"></a><span class="lineno">   31</span><span class="comment"></span> </div>
<div class="line"><a id="l00032" name="l00032"></a><span class="lineno">   32</span><span class="comment">/**</span></div>
<div class="line"><a id="l00033" name="l00033"></a><span class="lineno">   33</span><span class="comment"> * Utility/traits type to concisely work with final-validation functions when calling methods like</span></div>
<div class="line"><a id="l00034" name="l00034"></a><span class="lineno">   34</span><span class="comment"> * Config_manager::apply_static().</span></div>
<div class="line"><a id="l00035" name="l00035"></a><span class="lineno">   35</span><span class="comment"> *</span></div>
<div class="line"><a id="l00036" name="l00036"></a><span class="lineno">   36</span><span class="comment"> * @tparam Value_set</span></div>
<div class="line"><a id="l00037" name="l00037"></a><span class="lineno">   37</span><span class="comment"> *         See Option_set.</span></div>
<div class="line"><a id="l00038" name="l00038"></a><span class="lineno">   38</span><span class="comment"> */</span></div>
<div class="line"><a id="l00039" name="l00039"></a><span class="lineno">   39</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l00040" name="l00040"></a><span class="lineno"><a class="line" href="structflow_1_1cfg_1_1Final__validator__func.html">   40</a></span><span class="keyword">struct </span><a class="code hl_struct" href="structflow_1_1cfg_1_1Final__validator__func.html">Final_validator_func</a></div>
<div class="line"><a id="l00041" name="l00041"></a><span class="lineno">   41</span>{</div>
<div class="line"><a id="l00042" name="l00042"></a><span class="lineno">   42</span>  <span class="comment">// Types.</span></div>
<div class="line"><a id="l00043" name="l00043"></a><span class="lineno">   43</span><span class="comment"></span> </div>
<div class="line"><a id="l00044" name="l00044"></a><span class="lineno">   44</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00045" name="l00045"></a><span class="lineno">   45</span><span class="comment">   * Short-hand for a function that takes a parsed config set (meaning all values are individually OK) and returns</span></div>
<div class="line"><a id="l00046" name="l00046"></a><span class="lineno">   46</span><span class="comment">   * what `Config_manager::apply*()` should do to the candidate-for-canonical-state `Value_set` maintained</span></div>
<div class="line"><a id="l00047" name="l00047"></a><span class="lineno">   47</span><span class="comment">   * by Config_manager.  Informally its logic should be:</span></div>
<div class="line"><a id="l00048" name="l00048"></a><span class="lineno">   48</span><span class="comment">   *   - (Optional) Does `Value_set` indicate that the file that was parsed should be skipped wholesale?  If so</span></div>
<div class="line"><a id="l00049" name="l00049"></a><span class="lineno">   49</span><span class="comment">   *     yield Final_validator_outcome::S_SKIP.  Else:</span></div>
<div class="line"><a id="l00050" name="l00050"></a><span class="lineno">   50</span><span class="comment">   *   - If there are no further inter-option problems (given that individually each option value is okay)</span></div>
<div class="line"><a id="l00051" name="l00051"></a><span class="lineno">   51</span><span class="comment">   *     yield Final_validator_outcome::S_ACCEPT.  Else yield Final_validator_outcome::S_FAIL.</span></div>
<div class="line"><a id="l00052" name="l00052"></a><span class="lineno">   52</span><span class="comment">   */</span></div>
<div class="line"><a id="l00053" name="l00053"></a><span class="lineno"><a class="line" href="structflow_1_1cfg_1_1Final__validator__func.html#a5475ab0b6e93f2ccded2aa8690ace0a4">   53</a></span>  <span class="keyword">using </span><a class="code hl_class" href="classflow_1_1Function.html">Type</a> = <a class="code hl_class" href="classflow_1_1Function.html">Function</a>&lt;<a class="code hl_enumeration" href="namespaceflow_1_1cfg.html#a80b3319f3d3a657837d0d8b28d22ccc3">Final_validator_outcome</a> (<span class="keyword">const</span> Value_set&amp;)&gt;;</div>
<div class="line"><a id="l00054" name="l00054"></a><span class="lineno">   54</span> </div>
<div class="line"><a id="l00055" name="l00055"></a><span class="lineno">   55</span>  <span class="comment">// Methods.</span></div>
<div class="line"><a id="l00056" name="l00056"></a><span class="lineno">   56</span><span class="comment"></span> </div>
<div class="line"><a id="l00057" name="l00057"></a><span class="lineno">   57</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00058" name="l00058"></a><span class="lineno">   58</span><span class="comment">   * Returns a final-validator function that simply always returns Final_validator_outcome::S_ACCEPT.</span></div>
<div class="line"><a id="l00059" name="l00059"></a><span class="lineno">   59</span><span class="comment">   * @return See above.</span></div>
<div class="line"><a id="l00060" name="l00060"></a><span class="lineno">   60</span><span class="comment">   */</span></div>
<div class="line"><a id="l00061" name="l00061"></a><span class="lineno">   61</span>  <span class="keyword">static</span> <a class="code hl_class" href="classflow_1_1Function.html">Type</a> <a class="code hl_function" href="structflow_1_1cfg_1_1Final__validator__func.html#aa930ac2fbe3ad6abc07994984f875c81">null</a>();</div>
<div class="line"><a id="l00062" name="l00062"></a><span class="lineno">   62</span>}; <span class="comment">// struct Final_validator_func</span></div>
<div class="line"><a id="l00063" name="l00063"></a><span class="lineno">   63</span><span class="comment"></span> </div>
<div class="line"><a id="l00064" name="l00064"></a><span class="lineno">   64</span><span class="comment">/**</span></div>
<div class="line"><a id="l00065" name="l00065"></a><span class="lineno">   65</span><span class="comment"> * Empty `struct` suitable as a `*_value_set` template arg for Config_manager, when a slot requires a `Value_set`, but</span></div>
<div class="line"><a id="l00066" name="l00066"></a><span class="lineno">   66</span><span class="comment"> * you have no config to actually parse there.  In particular, if you have a static `Value_set` but no corresponding</span></div>
<div class="line"><a id="l00067" name="l00067"></a><span class="lineno">   67</span><span class="comment"> * dynamic one, you should provide this as the template arg.</span></div>
<div class="line"><a id="l00068" name="l00068"></a><span class="lineno">   68</span><span class="comment"> *</span></div>
<div class="line"><a id="l00069" name="l00069"></a><span class="lineno">   69</span><span class="comment"> * @see null_declare_opts_func() and null_final_validator_func().</span></div>
<div class="line"><a id="l00070" name="l00070"></a><span class="lineno">   70</span><span class="comment"> */</span></div>
<div class="line"><a id="l00071" name="l00071"></a><span class="lineno"><a class="line" href="structflow_1_1cfg_1_1Null__value__set.html">   71</a></span><span class="keyword">struct </span><a class="code hl_struct" href="structflow_1_1cfg_1_1Null__value__set.html">Null_value_set</a> :</div>
<div class="line"><a id="l00072" name="l00072"></a><span class="lineno">   72</span>  <span class="keyword">public</span> <a class="code hl_class" href="classflow_1_1util_1_1Shared__ptr__alias__holder.html">util::Shared_ptr_alias_holder</a>&lt;boost::shared_ptr&lt;Null_value_set&gt;&gt;</div>
<div class="line"><a id="l00073" name="l00073"></a><span class="lineno">   73</span>{</div>
<div class="line"><a id="l00074" name="l00074"></a><span class="lineno">   74</span>};</div>
<div class="line"><a id="l00075" name="l00075"></a><span class="lineno">   75</span><span class="comment"></span> </div>
<div class="line"><a id="l00076" name="l00076"></a><span class="lineno">   76</span><span class="comment">/**</span></div>
<div class="line"><a id="l00077" name="l00077"></a><span class="lineno">   77</span><span class="comment"> * Manages a config setup, intended for a single daemon process, by maintaining</span></div>
<div class="line"><a id="l00078" name="l00078"></a><span class="lineno">   78</span><span class="comment"> * 1 or more set(s) of static config and dynamic config, each, via that number of `Option_set&lt;&gt;`-ready raw value</span></div>
<div class="line"><a id="l00079" name="l00079"></a><span class="lineno">   79</span><span class="comment"> * `struct` types supplied by the user as template arguments.  There is an even number of template args (or it will</span></div>
<div class="line"><a id="l00080" name="l00080"></a><span class="lineno">   80</span><span class="comment"> * not compile); each successive pair contains, in order, a *static* `Value_set` followed by a *dynamic* one.</span></div>
<div class="line"><a id="l00081" name="l00081"></a><span class="lineno">   81</span><span class="comment"> * It is possible, for each given pair, to use static config alone or dynamic config alone; in that case pass in</span></div>
<div class="line"><a id="l00082" name="l00082"></a><span class="lineno">   82</span><span class="comment"> * Null_value_set for the unused one:</span></div>
<div class="line"><a id="l00083" name="l00083"></a><span class="lineno">   83</span><span class="comment"> *</span></div>
<div class="line"><a id="l00084" name="l00084"></a><span class="lineno">   84</span><span class="comment"> *   ~~~</span></div>
<div class="line"><a id="l00085" name="l00085"></a><span class="lineno">   85</span><span class="comment"> *   // First config pair is static-only; second config pair -- for a separate application module perhaps --</span></div>
<div class="line"><a id="l00086" name="l00086"></a><span class="lineno">   86</span><span class="comment"> *   // has both a static and dynamic parts.</span></div>
<div class="line"><a id="l00087" name="l00087"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a453d83bf1e8b57b1aaff511fbe913ecc">   87</a></span><span class="comment"> *   flow::cfg::Config_manager&lt;Static_config_general, Null_value_set, Static_socket_opts, Dynamic_socket_opts&gt; ...;</span></div>
<div class="line"><a id="l00088" name="l00088"></a><span class="lineno">   88</span><span class="comment"> *   ~~~</span></div>
<div class="line"><a id="l00089" name="l00089"></a><span class="lineno">   89</span><span class="comment"> *</span></div>
<div class="line"><a id="l00090" name="l00090"></a><span class="lineno">   90</span><span class="comment"> * @see Static_config_manager for the probably-common use case when you have only static config and only one `struct`</span></div>
<div class="line"><a id="l00091" name="l00091"></a><span class="lineno">   91</span><span class="comment"> *      at that.  Static_config_manager adapts Config_manager with a very simple API, avoiding parameter packs</span></div>
<div class="line"><a id="l00092" name="l00092"></a><span class="lineno">   92</span><span class="comment"> *      and any mention of various dynamic-config complexities.</span></div>
<div class="line"><a id="l00093" name="l00093"></a><span class="lineno">   93</span><span class="comment"> *</span></div>
<div class="line"><a id="l00094" name="l00094"></a><span class="lineno">   94</span><span class="comment"> * @todo Dynamic config support lacks crash rejection; though these features should be an incremental improvement</span></div>
<div class="line"><a id="l00095" name="l00095"></a><span class="lineno">   95</span><span class="comment"> * around the existing code.  By crash rejection I mean something like: config file</span></div>
<div class="line"><a id="l00096" name="l00096"></a><span class="lineno">   96</span><span class="comment"> * X comes in; we rename it to X.unparsed; we try to parse it; program crashes -- versus it&#39;s fine, so we rename it</span></div>
<div class="line"><a id="l00097" name="l00097"></a><span class="lineno">   97</span><span class="comment"> * X.parsed, and next time X.parsed is what we presumably-safely parse after any restart.  Similarly invalid config</span></div>
<div class="line"><a id="l00098" name="l00098"></a><span class="lineno">   98</span><span class="comment"> * may not cause a crash but still shouldn&#39;t be repeatedly re-parsed (etc.).  Exact design TBD and will be informed</span></div>
<div class="line"><a id="l00099" name="l00099"></a><span class="lineno">   99</span><span class="comment"> * by previous work on other projects (by echan and ygoldfel at least).</span></div>
<div class="line"><a id="l00100" name="l00100"></a><span class="lineno">  100</span><span class="comment"> *</span></div>
<div class="line"><a id="l00101" name="l00101"></a><span class="lineno">  101</span><span class="comment"> * ### When (and how) to use this ###</span></div>
<div class="line"><a id="l00102" name="l00102"></a><span class="lineno">  102</span><span class="comment"> * First see the namespace flow::cfg doc header for a brief overview.  If you have chosen to use flow::cfg for (at least</span></div>
<div class="line"><a id="l00103" name="l00103"></a><span class="lineno">  103</span><span class="comment"> * some of) your config needs, what is mandatory to use is the class template Option_set.  The choice is to use it</span></div>
<div class="line"><a id="l00104" name="l00104"></a><span class="lineno">  104</span><span class="comment"> * directly (writing your own facilities around it) or to use this Config_manager to maintain a couple of `Option_set`s</span></div>
<div class="line"><a id="l00105" name="l00105"></a><span class="lineno">  105</span><span class="comment"> * for you in a straightforward way.  Config_manager supports that one straightforward way, and for daemon programs</span></div>
<div class="line"><a id="l00106" name="l00106"></a><span class="lineno">  106</span><span class="comment"> * it may be a good choice.  Otherwise, the idea behind Option_set is to be able to flexibly use them as needed</span></div>
<div class="line"><a id="l00107" name="l00107"></a><span class="lineno">  107</span><span class="comment"> * (Config_manager providing one such way).</span></div>
<div class="line"><a id="l00108" name="l00108"></a><span class="lineno">  108</span><span class="comment"> *</span></div>
<div class="line"><a id="l00109" name="l00109"></a><span class="lineno">  109</span><span class="comment"> * Firstly, you may create a `const` (immutable) Config_manager via its constructor and then just use it to output</span></div>
<div class="line"><a id="l00110" name="l00110"></a><span class="lineno">  110</span><span class="comment"> * a help message (log_help() or help_to_ostream()).  This could be used with your program&#39;s `--help` option or similar,</span></div>
<div class="line"><a id="l00111" name="l00111"></a><span class="lineno">  111</span><span class="comment"> * and that&#39;s it (no parsing takes place).</span></div>
<div class="line"><a id="l00112" name="l00112"></a><span class="lineno">  112</span><span class="comment"> *</span></div>
<div class="line"><a id="l00113" name="l00113"></a><span class="lineno">  113</span><span class="comment"> *   ~~~</span></div>
<div class="line"><a id="l00114" name="l00114"></a><span class="lineno">  114</span><span class="comment"> *   // Example of a static-config-only Config_manager created just to log the help, and that&#39;s it.</span></div>
<div class="line"><a id="l00115" name="l00115"></a><span class="lineno">  115</span><span class="comment"> *   flow::cfg::Config_manager&lt;Static_value_set, Null_value_set&gt;</span></div>
<div class="line"><a id="l00116" name="l00116"></a><span class="lineno">  116</span><span class="comment"> *     (get_logger(), &quot;cfg&quot;, &amp;static_cfg_declare_opts, flow::cfg::null_declare_opts_func())</span></div>
<div class="line"><a id="l00117" name="l00117"></a><span class="lineno">  117</span><span class="comment"> *     .log_help();</span></div>
<div class="line"><a id="l00118" name="l00118"></a><span class="lineno">  118</span><span class="comment"> *   ~~~</span></div>
<div class="line"><a id="l00119" name="l00119"></a><span class="lineno">  119</span><span class="comment"> *</span></div>
<div class="line"><a id="l00120" name="l00120"></a><span class="lineno">  120</span><span class="comment"> * Orthogonally, of course, you may want to use it to parse things.  In which case:</span></div>
<div class="line"><a id="l00121" name="l00121"></a><span class="lineno">  121</span><span class="comment"> *</span></div>
<div class="line"><a id="l00122" name="l00122"></a><span class="lineno">  122</span><span class="comment"> * Config_manager assumes the following setup:</span></div>
<div class="line"><a id="l00123" name="l00123"></a><span class="lineno">  123</span><span class="comment"> *   - 1 or more config sets, each applicable perhaps to a different module of your application/library/etc.</span></div>
<div class="line"><a id="l00124" name="l00124"></a><span class="lineno">  124</span><span class="comment"> *     For *each* config set, have 1 or both of the following.  (Having neither is pointless; so do not.  Officially</span></div>
<div class="line"><a id="l00125" name="l00125"></a><span class="lineno">  125</span><span class="comment"> *     behavior is undefined if you do this.)</span></div>
<div class="line"><a id="l00126" name="l00126"></a><span class="lineno">  126</span><span class="comment"> *     - One set of values, such that it is read from config source(s) once; then no value therein ever changes again.</span></div>
<div class="line"><a id="l00127" name="l00127"></a><span class="lineno">  127</span><span class="comment"> *       Call this type `S_value_set` (S for static).</span></div>
<div class="line"><a id="l00128" name="l00128"></a><span class="lineno">  128</span><span class="comment"> *       `S_value_set` must be a type suitable for Option_set as its `Value_set` template arg.  See Option_set doc</span></div>
<div class="line"><a id="l00129" name="l00129"></a><span class="lineno">  129</span><span class="comment"> *       header.  Spoiler alert: It essentially needs to be a `struct` of reasonably-copyable,</span></div>
<div class="line"><a id="l00130" name="l00130"></a><span class="lineno">  130</span><span class="comment"> *       reasonably-equality-comparable, stream-parseable, stream-printable scalars (possibly nested); it needs to</span></div>
<div class="line"><a id="l00131" name="l00131"></a><span class="lineno">  131</span><span class="comment"> *       declare its default values in a no-arg ctor; and it needs an option-declaring function that calls</span></div>
<div class="line"><a id="l00132" name="l00132"></a><span class="lineno">  132</span><span class="comment"> *       FLOW_CFG_OPTION_SET_DECLARE_OPTION() for each data member therein.  The latter function must be passed to</span></div>
<div class="line"><a id="l00133" name="l00133"></a><span class="lineno">  133</span><span class="comment"> *       Config_manager ctor.</span></div>
<div class="line"><a id="l00134" name="l00134"></a><span class="lineno">  134</span><span class="comment"> *       - After ctor, static config stored herein will be at its default values.  Call apply_static() (or</span></div>
<div class="line"><a id="l00135" name="l00135"></a><span class="lineno">  135</span><span class="comment"> *         apply_static_and_dynamic(); see below) to read the static values (from a file, etc.).</span></div>
<div class="line"><a id="l00136" name="l00136"></a><span class="lineno">  136</span><span class="comment"> *       - This `S_value_set` is accessible by reference-to-immutable accessor static_values() or by</span></div>
<div class="line"><a id="l00137" name="l00137"></a><span class="lineno">  137</span><span class="comment"> *         all_static_values().</span></div>
<div class="line"><a id="l00138" name="l00138"></a><span class="lineno">  138</span><span class="comment"> *         - static_values() and all_static_values() are essentially thread-safe, at least after apply_static(), in that</span></div>
<div class="line"><a id="l00139" name="l00139"></a><span class="lineno">  139</span><span class="comment"> *           static_values() will always return a reference to the same `S_value_set` and all_static_values() will</span></div>
<div class="line"><a id="l00140" name="l00140"></a><span class="lineno">  140</span><span class="comment"> *           always emit the same pointers, and the values within the `S_value_set`(s) shall never change.</span></div>
<div class="line"><a id="l00141" name="l00141"></a><span class="lineno">  141</span><span class="comment"> *     - A 2nd set of values, such that it is read from config source(s) at least once; but then potentially</span></div>
<div class="line"><a id="l00142" name="l00142"></a><span class="lineno">  142</span><span class="comment"> *       more times, and each time 0 or more of the values may be changed from the original setting.</span></div>
<div class="line"><a id="l00143" name="l00143"></a><span class="lineno">  143</span><span class="comment"> *       `D_value_set`, again, must be a type suitable for Option_set as its `Value_set`.</span></div>
<div class="line"><a id="l00144" name="l00144"></a><span class="lineno">  144</span><span class="comment"> *       - Initialize the first set of dynamic values by calling either apply_static_and_dynamic() (if your setup allows</span></div>
<div class="line"><a id="l00145" name="l00145"></a><span class="lineno">  145</span><span class="comment"> *         for initial dynamic values to be supplied in the same config source(s) (e.g., same file) as static ones)</span></div>
<div class="line"><a id="l00146" name="l00146"></a><span class="lineno">  146</span><span class="comment"> *         *and* then apply_dynamic(); or *only* the latter.</span></div>
<div class="line"><a id="l00147" name="l00147"></a><span class="lineno">  147</span><span class="comment"> *       - After that initial `apply*_dynamic()`: dynamic_values() returns a ref-counted pointer to the heap-allocated</span></div>
<div class="line"><a id="l00148" name="l00148"></a><span class="lineno">  148</span><span class="comment"> *         `D_value_set` canonical at that time.  dynamic_values() may return a different pointer each time (and</span></div>
<div class="line"><a id="l00149" name="l00149"></a><span class="lineno">  149</span><span class="comment"> *         will, if a dynamic change is detected); but the values *at* a given return pointer will *never* change.</span></div>
<div class="line"><a id="l00150" name="l00150"></a><span class="lineno">  150</span><span class="comment"> *         all_dynamic_values() is an alternate approach but essentially the same idea.</span></div>
<div class="line"><a id="l00151" name="l00151"></a><span class="lineno">  151</span><span class="comment"> *       - Now, whenever you have reason to believe the dynamic config may have changed, call apply_dynamic().</span></div>
<div class="line"><a id="l00152" name="l00152"></a><span class="lineno">  152</span><span class="comment"> *         - apply_dynamic() (after the first one) and dynamic_values() are mutually thread-safe: they can be safely</span></div>
<div class="line"><a id="l00153" name="l00153"></a><span class="lineno">  153</span><span class="comment"> *           called concurrently with each other and/or themselves.  Internally, an atomic pointer to `D_value_set`</span></div>
<div class="line"><a id="l00154" name="l00154"></a><span class="lineno">  154</span><span class="comment"> *           is stored; `apply_dynamic()` makes a single update to it -- after a potentially lengthy successful parse</span></div>
<div class="line"><a id="l00155" name="l00155"></a><span class="lineno">  155</span><span class="comment"> *           of config source(s) -- while dynamic_values() makes an atomic read followed by a pointer copy (and</span></div>
<div class="line"><a id="l00156" name="l00156"></a><span class="lineno">  156</span><span class="comment"> *           returns the copy).  The ref-counted-ptr handle ensures the returned `D_value_set` survives as long</span></div>
<div class="line"><a id="l00157" name="l00157"></a><span class="lineno">  157</span><span class="comment"> *           as the user needs it, even if it&#39;s immediately replaced by new config within the Config_manager.</span></div>
<div class="line"><a id="l00158" name="l00158"></a><span class="lineno">  158</span><span class="comment"> *         - Since dynamic config can change at any time, it is up to the config user how they want to operate on the</span></div>
<div class="line"><a id="l00159" name="l00159"></a><span class="lineno">  159</span><span class="comment"> *           ref-counted handle obtained from dynamic_values().  If a potentially new value each time is fine, it&#39;s fine</span></div>
<div class="line"><a id="l00160" name="l00160"></a><span class="lineno">  160</span><span class="comment"> *           to simply do `cm.dynamic_values()-&gt;m_some_opt`.  If one needs a consistent set of 2 or more values, or</span></div>
<div class="line"><a id="l00161" name="l00161"></a><span class="lineno">  161</span><span class="comment"> *           if one needs values to not change over time, then one can simply save `auto dyn_cfg = cm.dynamic_values()`</span></div>
<div class="line"><a id="l00162" name="l00162"></a><span class="lineno">  162</span><span class="comment"> *           and then access values through `dyn_cfg-&gt;` as long as consistency is desired.  (Again: `*dyn_cfg` can never</span></div>
<div class="line"><a id="l00163" name="l00163"></a><span class="lineno">  163</span><span class="comment"> *           change, once `dyn_cfg` is returned through dynamic_values().)</span></div>
<div class="line"><a id="l00164" name="l00164"></a><span class="lineno">  164</span><span class="comment"> *       - You may also have hooks executed when dynamic config changes.  This is a simple system: before</span></div>
<div class="line"><a id="l00165" name="l00165"></a><span class="lineno">  165</span><span class="comment"> *         any relevant `apply*_dynamic()` calls, call register_dynamic_change_listener() for each module that</span></div>
<div class="line"><a id="l00166" name="l00166"></a><span class="lineno">  166</span><span class="comment"> *         wants to be informed.  Each callback so registered will be *synchronously* executed from `apply*_dynamic()`,</span></div>
<div class="line"><a id="l00167" name="l00167"></a><span class="lineno">  167</span><span class="comment"> *         when a relevant change is detected.</span></div>
<div class="line"><a id="l00168" name="l00168"></a><span class="lineno">  168</span><span class="comment"> *</span></div>
<div class="line"><a id="l00169" name="l00169"></a><span class="lineno">  169</span><span class="comment"> * To summarize: This is the assumed order of API calls on a given `*this`; other orders may lead to undefined behavior:</span></div>
<div class="line"><a id="l00170" name="l00170"></a><span class="lineno">  170</span><span class="comment"> *   - Config_manager ctor.</span></div>
<div class="line"><a id="l00171" name="l00171"></a><span class="lineno">  171</span><span class="comment"> *   - apply_static() or (if using dynamic config, but even so still optional) apply_static_and_dynamic().</span></div>
<div class="line"><a id="l00172" name="l00172"></a><span class="lineno">  172</span><span class="comment"> *   - If using dynamic config: apply_dynamic().</span></div>
<div class="line"><a id="l00173" name="l00173"></a><span class="lineno">  173</span><span class="comment"> *   - Simultaneously/at various times (thread-safe w/r/t each other):</span></div>
<div class="line"><a id="l00174" name="l00174"></a><span class="lineno">  174</span><span class="comment"> *     - static_values() (always returns a reference to the same immutable `S_value_set`).</span></div>
<div class="line"><a id="l00175" name="l00175"></a><span class="lineno">  175</span><span class="comment"> *     - all_static_values() (always emits the same pointers to immutable `S_value_set`s).</span></div>
<div class="line"><a id="l00176" name="l00176"></a><span class="lineno">  176</span><span class="comment"> *     - If using dynamic config: dynamic_values() (if returned `x`, `*x` is immutable; but may return different `x`es</span></div>
<div class="line"><a id="l00177" name="l00177"></a><span class="lineno">  177</span><span class="comment"> *       over time).  Alternatively: all_dynamic_values().</span></div>
<div class="line"><a id="l00178" name="l00178"></a><span class="lineno">  178</span><span class="comment"> *     - apply_dynamic() (changes ptr returned by dynamic_values() and all_dynamic_values()).</span></div>
<div class="line"><a id="l00179" name="l00179"></a><span class="lineno">  179</span><span class="comment"> *   - Config-using modules&#39; destructors/deinitialization code.</span></div>
<div class="line"><a id="l00180" name="l00180"></a><span class="lineno">  180</span><span class="comment"> *     - For each such module: Obviously it must run after the last `*ic_values()` call.</span></div>
<div class="line"><a id="l00181" name="l00181"></a><span class="lineno">  181</span><span class="comment"> *     - For each such module: It *must* run before Config_manager dtor.</span></div>
<div class="line"><a id="l00182" name="l00182"></a><span class="lineno">  182</span><span class="comment"> *   - Config_manager dtor.</span></div>
<div class="line"><a id="l00183" name="l00183"></a><span class="lineno">  183</span><span class="comment"> *</span></div>
<div class="line"><a id="l00184" name="l00184"></a><span class="lineno">  184</span><span class="comment"> * In addition, between Config_manager ctor and dtor:</span></div>
<div class="line"><a id="l00185" name="l00185"></a><span class="lineno">  185</span><span class="comment"> *   - (Optional) If using dynamic config: register_dynamic_change_listener() (for each module interested in it);</span></div>
<div class="line"><a id="l00186" name="l00186"></a><span class="lineno">  186</span><span class="comment"> *     not thread-safe against concurrent apply_dynamic(), apply_static_and_dynamic(), or</span></div>
<div class="line"><a id="l00187" name="l00187"></a><span class="lineno">  187</span><span class="comment"> *     unregister_dynamic_change_listener().</span></div>
<div class="line"><a id="l00188" name="l00188"></a><span class="lineno">  188</span><span class="comment"> *     - Functions `register_dynamic_change_listener()`ed earlier may execute synchronously from within</span></div>
<div class="line"><a id="l00189" name="l00189"></a><span class="lineno">  189</span><span class="comment"> *       apply_dynamic() and/or apply_static_and_dynamic().</span></div>
<div class="line"><a id="l00190" name="l00190"></a><span class="lineno">  190</span><span class="comment"> *       - Such user functions may load async work elsewhere.</span></div>
<div class="line"><a id="l00191" name="l00191"></a><span class="lineno">  191</span><span class="comment"> *       - Ensure that thing onto which they load async work exists!  See register_dynamic_change_listener() for</span></div>
<div class="line"><a id="l00192" name="l00192"></a><span class="lineno">  192</span><span class="comment"> *         useful patterns to ensure this.</span></div>
<div class="line"><a id="l00193" name="l00193"></a><span class="lineno">  193</span><span class="comment"> *   - (Optional) If a callback has been registered: unregister_dynamic_change_listener(); not thread-safe against</span></div>
<div class="line"><a id="l00194" name="l00194"></a><span class="lineno">  194</span><span class="comment"> *     concurrent apply_dynamic(), apply_static_and_dynamic(), or unregister_dynamic_change_listener().</span></div>
<div class="line"><a id="l00195" name="l00195"></a><span class="lineno">  195</span><span class="comment"> *     - Any callback which accesses something which can be invalidated SHOULD be unregistered before that thing becomes</span></div>
<div class="line"><a id="l00196" name="l00196"></a><span class="lineno">  196</span><span class="comment"> *       invalid.  If there is a chance that apply_dynamic() or apply_static_and_dynamic() might be called after it</span></div>
<div class="line"><a id="l00197" name="l00197"></a><span class="lineno">  197</span><span class="comment"> *       has become invalid, then the callback MUST be unregistered (otherwise, undefined behavior could be encountered</span></div>
<div class="line"><a id="l00198" name="l00198"></a><span class="lineno">  198</span><span class="comment"> *       when the invalid thing is accessed).</span></div>
<div class="line"><a id="l00199" name="l00199"></a><span class="lineno">  199</span><span class="comment"> *</span></div>
<div class="line"><a id="l00200" name="l00200"></a><span class="lineno">  200</span><span class="comment"> * ### Advanced feature: multi-source parsing and source skipping ###</span></div>
<div class="line"><a id="l00201" name="l00201"></a><span class="lineno">  201</span><span class="comment"> * By default this feature is not in play, as the `bool commit` arg to apply_static_and_dynamic(), apply_static(),</span></div>
<div class="line"><a id="l00202" name="l00202"></a><span class="lineno">  202</span><span class="comment"> * and apply_dynamic() defaults to `true`.  The multi-source feature is enabled by the user setting it to `false`</span></div>
<div class="line"><a id="l00203" name="l00203"></a><span class="lineno">  203</span><span class="comment"> * for some calls to `apply_*()`.  To explain how it works consider one particular `Value_set` and an attempt</span></div>
<div class="line"><a id="l00204" name="l00204"></a><span class="lineno">  204</span><span class="comment"> * to execute one of `apply_*()` methods w/r/t that `Value_set` (among potentially others to which the same</span></div>
<div class="line"><a id="l00205" name="l00205"></a><span class="lineno">  205</span><span class="comment"> * discussion applies equally).  For purposes of discussion assume it is a dynamic `Value_set`, and the operation</span></div>
<div class="line"><a id="l00206" name="l00206"></a><span class="lineno">  206</span><span class="comment"> * in question is apply_dynamic(); the same points apply to static ones and the other two `apply_*()` calls</span></div>
<div class="line"><a id="l00207" name="l00207"></a><span class="lineno">  207</span><span class="comment"> * except where noted below.</span></div>
<div class="line"><a id="l00208" name="l00208"></a><span class="lineno">  208</span><span class="comment"> *</span></div>
<div class="line"><a id="l00209" name="l00209"></a><span class="lineno">  209</span><span class="comment"> * Suppose the canonical (as returned by dynamic_values() or all_dynamic_values()) `Value_set` is in state B,</span></div>
<div class="line"><a id="l00210" name="l00210"></a><span class="lineno">  210</span><span class="comment"> * the baseline state.  (If `Value_set` is static, then B is the default state from default-cted `Value_set`, and</span></div>
<div class="line"><a id="l00211" name="l00211"></a><span class="lineno">  211</span><span class="comment"> * the canonical-state accessors are static_values() and all_static_values().)</span></div>
<div class="line"><a id="l00212" name="l00212"></a><span class="lineno">  212</span><span class="comment"> * Normally a single *update* consists of just one call to `apply_dynamic(commit = true)`:</span></div>
<div class="line"><a id="l00213" name="l00213"></a><span class="lineno">  213</span><span class="comment"> *   -# `R = apply_dynamic(P, F, true)`, where `P` is a file path, and `F` is your Final_validator_func::Type function.</span></div>
<div class="line"><a id="l00214" name="l00214"></a><span class="lineno">  214</span><span class="comment"> *</span></div>
<div class="line"><a id="l00215" name="l00215"></a><span class="lineno">  215</span><span class="comment"> * If `F() == Final_validator_outcome::S_FAIL`, then `R == false`; state stays at B.</span></div>
<div class="line"><a id="l00216" name="l00216"></a><span class="lineno">  216</span><span class="comment"> * If it&#39;s `F() == S_ACCEPT` (and the individual options were all fine), then `R == true`; state becomes B&#39;;</span></div>
<div class="line"><a id="l00217" name="l00217"></a><span class="lineno">  217</span><span class="comment"> * and if B does not equal B&#39; (a change was detected), then the dynamic changes listener(s)</span></div>
<div class="line"><a id="l00218" name="l00218"></a><span class="lineno">  218</span><span class="comment"> * (from register_dynamic_change_listener()) are synchronously called before apply_dynamic() returns.</span></div>
<div class="line"><a id="l00219" name="l00219"></a><span class="lineno">  219</span><span class="comment"> * (That listener stuff does not apply to static `Value_set`s in apply_static() and apply_static_and_dynamic().)</span></div>
<div class="line"><a id="l00220" name="l00220"></a><span class="lineno">  220</span><span class="comment"> *</span></div>
<div class="line"><a id="l00221" name="l00221"></a><span class="lineno">  221</span><span class="comment"> * That&#39;s the default behavior without engaging this feature.  To engage the feature, one has to</span></div>
<div class="line"><a id="l00222" name="l00222"></a><span class="lineno">  222</span><span class="comment"> * call `apply_dynamic(commit = false)` at least once.  A single *update* now consists of 2+ calls</span></div>
<div class="line"><a id="l00223" name="l00223"></a><span class="lineno">  223</span><span class="comment"> * to `apply_dynamic()`:</span></div>
<div class="line"><a id="l00224" name="l00224"></a><span class="lineno">  224</span><span class="comment"> *   -# `R = apply_dynamic(P1, F, false)`; if `!R`, update failed/exit algorithm; else:</span></div>
<div class="line"><a id="l00225" name="l00225"></a><span class="lineno">  225</span><span class="comment"> *   -# `R = apply_dynamic(P2, F, false)`; if `!R`, update failed/exit algorithm; else:</span></div>
<div class="line"><a id="l00226" name="l00226"></a><span class="lineno">  226</span><span class="comment"> *   -# ...</span></div>
<div class="line"><a id="l00227" name="l00227"></a><span class="lineno">  227</span><span class="comment"> *   -# `R = apply_dynamic(Pn, F, true)`; if `!R`, update failed/exit algorithm; else done.</span></div>
<div class="line"><a id="l00228" name="l00228"></a><span class="lineno">  228</span><span class="comment"> *       The `true` arg indicates the final call.</span></div>
<div class="line"><a id="l00229" name="l00229"></a><span class="lineno">  229</span><span class="comment"> *</span></div>
<div class="line"><a id="l00230" name="l00230"></a><span class="lineno">  230</span><span class="comment"> * (`F` can be different each time, though informally we suspect that would be unorthodox.  It is allowed formally.)</span></div>
<div class="line"><a id="l00231" name="l00231"></a><span class="lineno">  231</span><span class="comment"> *</span></div>
<div class="line"><a id="l00232" name="l00232"></a><span class="lineno">  232</span><span class="comment"> * Each apply_dynamic() call builds up a *candidate* `Value_set C` which is created (at the top of call 1)</span></div>
<div class="line"><a id="l00233" name="l00233"></a><span class="lineno">  233</span><span class="comment"> * to equal baseline/initial state B and then potentially incrementally morphed by each apply_dynamic() call.</span></div>
<div class="line"><a id="l00234" name="l00234"></a><span class="lineno">  234</span><span class="comment"> * Assuming no error (from individual validator or an `F() == S_FAIL`) at any stage, the effect on the *candidate*</span></div>
<div class="line"><a id="l00235" name="l00235"></a><span class="lineno">  235</span><span class="comment"> * `Value_set C` is as follows:</span></div>
<div class="line"><a id="l00236" name="l00236"></a><span class="lineno">  236</span><span class="comment"> *   -# If `F(Cnext) == S_ACCEPT`: Modify the *candidate* by overwriting it: `C = Cnext;`.</span></div>
<div class="line"><a id="l00237" name="l00237"></a><span class="lineno">  237</span><span class="comment"> *   -# If `F(Cnext) == S_SKIP`: Keep the *candidate* `Value_set C` unchanged from its current value at entry to that</span></div>
<div class="line"><a id="l00238" name="l00238"></a><span class="lineno">  238</span><span class="comment"> *      apply_dynamic() call.  `Cnext` is discarded (so the incremental update to the candidate is *skipped*).</span></div>
<div class="line"><a id="l00239" name="l00239"></a><span class="lineno">  239</span><span class="comment"> *</span></div>
<div class="line"><a id="l00240" name="l00240"></a><span class="lineno">  240</span><span class="comment"> * However, and this is the key:</span></div>
<div class="line"><a id="l00241" name="l00241"></a><span class="lineno">  241</span><span class="comment"> *   - `apply_dynamic(..., false)` does *not* modify the canonical (as returned by all_dynamic_values(), etc.)</span></div>
<div class="line"><a id="l00242" name="l00242"></a><span class="lineno">  242</span><span class="comment"> *     state.  It remains equal to B.  Hence no dynamic change listeners are invoked.  However:</span></div>
<div class="line"><a id="l00243" name="l00243"></a><span class="lineno">  243</span><span class="comment"> *   - the final call -- `apply_dynamic(..., true)` -- makes the canonical state equal the *candidate* `Value_set C`</span></div>
<div class="line"><a id="l00244" name="l00244"></a><span class="lineno">  244</span><span class="comment"> *     that has been built up.  Accordingly, before `apply_dynamic(..., true)` returns, if the canonical</span></div>
<div class="line"><a id="l00245" name="l00245"></a><span class="lineno">  245</span><span class="comment"> *     `Value_set B` differs from the candidate `Value_set C` that overwrites it, dynamic change listeners are</span></div>
<div class="line"><a id="l00246" name="l00246"></a><span class="lineno">  246</span><span class="comment"> *     invoked.</span></div>
<div class="line"><a id="l00247" name="l00247"></a><span class="lineno">  247</span><span class="comment"> *</span></div>
<div class="line"><a id="l00248" name="l00248"></a><span class="lineno">  248</span><span class="comment"> * (Hence the one-call update scenario (the vanilla one) is merely a degenerate case of the multi-call scenario;</span></div>
<div class="line"><a id="l00249" name="l00249"></a><span class="lineno">  249</span><span class="comment"> * as then the last call is the only call and thus canonicalizes the candidate and calls dynamic change listeners if</span></div>
<div class="line"><a id="l00250" name="l00250"></a><span class="lineno">  250</span><span class="comment"> * appropriate.)</span></div>
<div class="line"><a id="l00251" name="l00251"></a><span class="lineno">  251</span><span class="comment"> *</span></div>
<div class="line"><a id="l00252" name="l00252"></a><span class="lineno">  252</span><span class="comment"> * If at any stage `F(Cnext)` yields Final_validator_outcome::S_FAIL, then apply_dynamic() returns `false`.  This means</span></div>
<div class="line"><a id="l00253" name="l00253"></a><span class="lineno">  253</span><span class="comment"> * the entire update has failed; the *candidate* is abandoned, and you should not make the subsequent</span></div>
<div class="line"><a id="l00254" name="l00254"></a><span class="lineno">  254</span><span class="comment"> * apply_dynamic() calls that may be remaining in the update.  The next such call will be taken to be the 1st</span></div>
<div class="line"><a id="l00255" name="l00255"></a><span class="lineno">  255</span><span class="comment"> * of another update, with a fresh candidate C created to equal B.</span></div>
<div class="line"><a id="l00256" name="l00256"></a><span class="lineno">  256</span><span class="comment"> *</span></div>
<div class="line"><a id="l00257" name="l00257"></a><span class="lineno">  257</span><span class="comment"> * Why use this?  Why use 2+ files for a given update?  Indeed you shouldn&#39;t, unless there is specifically a good</span></div>
<div class="line"><a id="l00258" name="l00258"></a><span class="lineno">  258</span><span class="comment"> * reason.  What might that be?  The precipitating use case, and the basic one immediately obvious to the authors,</span></div>
<div class="line"><a id="l00259" name="l00259"></a><span class="lineno">  259</span><span class="comment"> * is where exactly for 1 of the files the final-validator shall return Final_validator_outcome::S_ACCEPT, while</span></div>
<div class="line"><a id="l00260" name="l00260"></a><span class="lineno">  260</span><span class="comment"> * for *all* others it will return Final_validator_outcome::S_SKIP.  For example, if your distributed network</span></div>
<div class="line"><a id="l00261" name="l00261"></a><span class="lineno">  261</span><span class="comment"> * consists of 3 sections, and each machine knows to which section it belongs, and each file is aimed at exactly 1</span></div>
<div class="line"><a id="l00262" name="l00262"></a><span class="lineno">  262</span><span class="comment"> * of the 3 and thus specifies it as some option `if-section-is=` (possible values 1 or 2 or 3), then the</span></div>
<div class="line"><a id="l00263" name="l00263"></a><span class="lineno">  263</span><span class="comment"> * final-validator func would:</span></div>
<div class="line"><a id="l00264" name="l00264"></a><span class="lineno">  264</span><span class="comment"> *   -# Check `if-section-is` option and return SKIP if the machine&#39;s actual section does not match it.  Else:</span></div>
<div class="line"><a id="l00265" name="l00265"></a><span class="lineno">  265</span><span class="comment"> *   -# Ensure internal consistency of candidate `Value_set` (as usual).</span></div>
<div class="line"><a id="l00266" name="l00266"></a><span class="lineno">  266</span><span class="comment"> *   -# Return FAIL or ACCEPT depending on the answer to that (as usual).</span></div>
<div class="line"><a id="l00267" name="l00267"></a><span class="lineno">  267</span><span class="comment"> *</span></div>
<div class="line"><a id="l00268" name="l00268"></a><span class="lineno">  268</span><span class="comment"> * Now you&#39;ve enabled conditional config in a distributed deployment.</span></div>
<div class="line"><a id="l00269" name="l00269"></a><span class="lineno">  269</span><span class="comment"> *</span></div>
<div class="line"><a id="l00270" name="l00270"></a><span class="lineno">  270</span><span class="comment"> * @warning In this *conditional config* use case, it is likely best to declare any given conditional option</span></div>
<div class="line"><a id="l00271" name="l00271"></a><span class="lineno">  271</span><span class="comment"> *          using a `_NO_ACC` variation of your `FLOW_CFG_OPTION_SET_DECLARE_OPTION*()` option of choice;</span></div>
<div class="line"><a id="l00272" name="l00272"></a><span class="lineno">  272</span><span class="comment"> *          that is `FLOW_CFG_OPTION_SET_DECLARE_OPTION_NO_ACC()` or similarly-postfixed variation.</span></div>
<div class="line"><a id="l00273" name="l00273"></a><span class="lineno">  273</span><span class="comment"> *          You probably do not want such an option&#39;s value to persist from an earlier file in the update to a later</span></div>
<div class="line"><a id="l00274" name="l00274"></a><span class="lineno">  274</span><span class="comment"> *          one; instead it should probably reset to its default &quot;at the top&quot; of each file; `_NO_ACC` variants</span></div>
<div class="line"><a id="l00275" name="l00275"></a><span class="lineno">  275</span><span class="comment"> *          will accomplish this.</span></div>
<div class="line"><a id="l00276" name="l00276"></a><span class="lineno">  276</span><span class="comment"> *</span></div>
<div class="line"><a id="l00277" name="l00277"></a><span class="lineno">  277</span><span class="comment"> * That said the use of SKIP (for all but 1) is not mandatory in such a multi-file-update setup.  You can never-SKIP,</span></div>
<div class="line"><a id="l00278" name="l00278"></a><span class="lineno">  278</span><span class="comment"> * or you can ACCEPT (not-SKIP) 2+ files; it is conceivable those setups have use cases as well.  Informally though we</span></div>
<div class="line"><a id="l00279" name="l00279"></a><span class="lineno">  279</span><span class="comment"> * reason to you as follows:</span></div>
<div class="line"><a id="l00280" name="l00280"></a><span class="lineno">  280</span><span class="comment"> *   - If you never SKIP, then why complicate matters by having updates consist of 2+ files in the first place?</span></div>
<div class="line"><a id="l00281" name="l00281"></a><span class="lineno">  281</span><span class="comment"> *     Isn&#39;t it simpler (for config deployment and other aspects of the system) to just keep it to 1?</span></div>
<div class="line"><a id="l00282" name="l00282"></a><span class="lineno">  282</span><span class="comment"> *   - If you ACCEPT (don&#39;t-SKIP) 2+ files, then merely looking at a given file will no longer easily show the resulting</span></div>
<div class="line"><a id="l00283" name="l00283"></a><span class="lineno">  283</span><span class="comment"> *     final config, as each individual update is now incremental in nature; a preceding file in the same update</span></div>
<div class="line"><a id="l00284" name="l00284"></a><span class="lineno">  284</span><span class="comment"> *     may have changed (versus baseline) some setting not mentioned in that particular file.  This may prove to be</span></div>
<div class="line"><a id="l00285" name="l00285"></a><span class="lineno">  285</span><span class="comment"> *     confusing.</span></div>
<div class="line"><a id="l00286" name="l00286"></a><span class="lineno">  286</span><span class="comment"> *     - If you ACCEPT (don&#39;t-SKIP) exactly 1 file, then this no longer the case, and things are simple enough again.</span></div>
<div class="line"><a id="l00287" name="l00287"></a><span class="lineno">  287</span><span class="comment"> *     - If you ACCEPT (don&#39;t-SKIP) 2+ files, then to mitigate the problem where the final config is not quite clear</span></div>
<div class="line"><a id="l00288" name="l00288"></a><span class="lineno">  288</span><span class="comment"> *       just by looking at the input files, it&#39;s simple to use state_to_ostream() or log_state() to direct the</span></div>
<div class="line"><a id="l00289" name="l00289"></a><span class="lineno">  289</span><span class="comment"> *       result to a file or the logs, for human viewing.</span></div>
<div class="line"><a id="l00290" name="l00290"></a><span class="lineno">  290</span><span class="comment"> *</span></div>
<div class="line"><a id="l00291" name="l00291"></a><span class="lineno">  291</span><span class="comment"> * The above are informal recommendations for maximum simplicity or clarity, but it is entirely conceivable a more</span></div>
<div class="line"><a id="l00292" name="l00292"></a><span class="lineno">  292</span><span class="comment"> * complex situation arises and requires they not be heeded.</span></div>
<div class="line"><a id="l00293" name="l00293"></a><span class="lineno">  293</span><span class="comment"> *</span></div>
<div class="line"><a id="l00294" name="l00294"></a><span class="lineno">  294</span><span class="comment"> * ### Relationship with the rest of your program/threads ###</span></div>
<div class="line"><a id="l00295" name="l00295"></a><span class="lineno">  295</span><span class="comment"> * At this time Config_manager is deliberately simple in that it doesn&#39;t start any threads of its own; it doesn&#39;t watch</span></div>
<div class="line"><a id="l00296" name="l00296"></a><span class="lineno">  296</span><span class="comment"> * file modifications to detect dynamic changes; and its methods can be called from any thread and always act</span></div>
<div class="line"><a id="l00297" name="l00297"></a><span class="lineno">  297</span><span class="comment"> * entirely synchronously.  (The only methods affected by thread considerations are apply_dynamic() and</span></div>
<div class="line"><a id="l00298" name="l00298"></a><span class="lineno">  298</span><span class="comment"> * dynamic_values() + all_dynamic_values(); they are intentionally thread-safe w/r/t each other.)</span></div>
<div class="line"><a id="l00299" name="l00299"></a><span class="lineno">  299</span><span class="comment"> *</span></div>
<div class="line"><a id="l00300" name="l00300"></a><span class="lineno">  300</span><span class="comment"> * To the extent that it uses callbacks -- again, only for dynamic config needs and only optionally -- they, too, are</span></div>
<div class="line"><a id="l00301" name="l00301"></a><span class="lineno">  301</span><span class="comment"> * executed synchronously.  However, these callbacks can (of course) `.post()` work onto boost.asio util::Task_engine</span></div>
<div class="line"><a id="l00302" name="l00302"></a><span class="lineno">  302</span><span class="comment"> * or async::Concurrent_task_loop or async::Single_thread_task_loop.</span></div>
<div class="line"><a id="l00303" name="l00303"></a><span class="lineno">  303</span><span class="comment"> *</span></div>
<div class="line"><a id="l00304" name="l00304"></a><span class="lineno">  304</span><span class="comment"> * Informally:</span></div>
<div class="line"><a id="l00305" name="l00305"></a><span class="lineno">  305</span><span class="comment"> * It is, however, possible and perhaps probable that one should build more facilities to detect cfg changes of various</span></div>
<div class="line"><a id="l00306" name="l00306"></a><span class="lineno">  306</span><span class="comment"> * kinds; for this thread(s) may be useful.  We suspect it is better to build class(es) that do that and make use of</span></div>
<div class="line"><a id="l00307" name="l00307"></a><span class="lineno">  307</span><span class="comment"> * Config_manager -- not expand Config_manager to do such things.  Its simplicity and relative light weight and</span></div>
<div class="line"><a id="l00308" name="l00308"></a><span class="lineno">  308</span><span class="comment"> * flexibility are good properties to conserve and not saddle with baggage (even optional baggage).</span></div>
<div class="line"><a id="l00309" name="l00309"></a><span class="lineno">  309</span><span class="comment"> *</span></div>
<div class="line"><a id="l00310" name="l00310"></a><span class="lineno">  310</span><span class="comment"> * ### Thread safety ###</span></div>
<div class="line"><a id="l00311" name="l00311"></a><span class="lineno">  311</span><span class="comment"> * This is discussed in bits and pieces above and in various doc headers.  Here is the overall picture however:</span></div>
<div class="line"><a id="l00312" name="l00312"></a><span class="lineno">  312</span><span class="comment"> *   - Separate Config_manager objects are independent of each other, so there are no thread safety issues.</span></div>
<div class="line"><a id="l00313" name="l00313"></a><span class="lineno">  313</span><span class="comment"> *   - For a given `*this`:</span></div>
<div class="line"><a id="l00314" name="l00314"></a><span class="lineno">  314</span><span class="comment"> *     - By default, no non-`const` method is safe to call concurrently with any other method.  Except:</span></div>
<div class="line"><a id="l00315" name="l00315"></a><span class="lineno">  315</span><span class="comment"> *     - dynamic_values() / all_dynamic_values() may be called concurrently with itself/each other or any other method</span></div>
<div class="line"><a id="l00316" name="l00316"></a><span class="lineno">  316</span><span class="comment"> *       including `apply_dynamic(commit = *)`, as long as either `apply_dynamic(commit = true)` or</span></div>
<div class="line"><a id="l00317" name="l00317"></a><span class="lineno">  317</span><span class="comment"> *       `apply_static_and_dynamic(commit = true)` has succeeded at least once prior.</span></div>
<div class="line"><a id="l00318" name="l00318"></a><span class="lineno">  318</span><span class="comment"> *</span></div>
<div class="line"><a id="l00319" name="l00319"></a><span class="lineno">  319</span><span class="comment"> * @tparam S_d_value_set</span></div>
<div class="line"><a id="l00320" name="l00320"></a><span class="lineno">  320</span><span class="comment"> *         An even number (at least 2) of settings `struct`s -- see Option_set doc header for requirements for each --</span></div>
<div class="line"><a id="l00321" name="l00321"></a><span class="lineno">  321</span><span class="comment"> *         in order static, dynamic, static, dynamic, ....  Use Null_value_set as needed; but do not use Null_value_set</span></div>
<div class="line"><a id="l00322" name="l00322"></a><span class="lineno">  322</span><span class="comment"> *         for both the static and dynamic parameter in a given pair (e.g., `&lt;Null_value_set, Null_value_set, ...&gt;`</span></div>
<div class="line"><a id="l00323" name="l00323"></a><span class="lineno">  323</span><span class="comment"> *         is both useless and formally disallowed).</span></div>
<div class="line"><a id="l00324" name="l00324"></a><span class="lineno">  324</span><span class="comment"> *</span></div>
<div class="line"><a id="l00325" name="l00325"></a><span class="lineno">  325</span><span class="comment"> * @internal</span></div>
<div class="line"><a id="l00326" name="l00326"></a><span class="lineno">  326</span><span class="comment"> * ### Implementation notes ###</span></div>
<div class="line"><a id="l00327" name="l00327"></a><span class="lineno">  327</span><span class="comment"> * I (ygoldfel) wrote this, originally, in 2 stages.  At first it only supported exactly 2 template args: one static</span></div>
<div class="line"><a id="l00328" name="l00328"></a><span class="lineno">  328</span><span class="comment"> * and one dynamic `Value_set`.  In the next stage I turned it into a parameter pack, so that 4, 6, 8, ... args</span></div>
<div class="line"><a id="l00329" name="l00329"></a><span class="lineno">  329</span><span class="comment"> * can be provided if desired -- to support multiple configurable modules in the application.  Before this I had done</span></div>
<div class="line"><a id="l00330" name="l00330"></a><span class="lineno">  330</span><span class="comment"> * some basic parameter-pack coding, but undoubtedly Config_manager is my first foray into this level of</span></div>
<div class="line"><a id="l00331" name="l00331"></a><span class="lineno">  331</span><span class="comment"> * sophistication.  Certainly I welcome changes to improve clarity of the implementation and other suggestions.</span></div>
<div class="line"><a id="l00332" name="l00332"></a><span class="lineno">  332</span><span class="comment"> * Generally speaking the code does strike me as complex, though there&#39;s a good case to be made to the effect of:</span></div>
<div class="line"><a id="l00333" name="l00333"></a><span class="lineno">  333</span><span class="comment"> * That is just the nature of the beast.  It&#39;s meta-programming: having the compiler perform loops, of a sort,</span></div>
<div class="line"><a id="l00334" name="l00334"></a><span class="lineno">  334</span><span class="comment"> * at *compile time*.  Because `S_d_value_set...` is not homogenous -- within each adjacent pair of tparams the first</span></div>
<div class="line"><a id="l00335" name="l00335"></a><span class="lineno">  335</span><span class="comment"> * and the second are *not* always treated equivalently -- the code has to be tricky at times.</span></div>
<div class="line"><a id="l00336" name="l00336"></a><span class="lineno">  336</span><span class="comment"> *</span></div>
<div class="line"><a id="l00337" name="l00337"></a><span class="lineno">  337</span><span class="comment"> * That said the usability of the API should not be affected by these details much.  At times one has to supply</span></div>
<div class="line"><a id="l00338" name="l00338"></a><span class="lineno">  338</span><span class="comment"> * additional `&lt;template args&gt;` -- apply_static() and apply_dynamic() come to mind in particular -- to help the</span></div>
<div class="line"><a id="l00339" name="l00339"></a><span class="lineno">  339</span><span class="comment"> * compiler; but the compiler will complain about being unable to deduce the tparams, and then the next action for the</span></div>
<div class="line"><a id="l00340" name="l00340"></a><span class="lineno">  340</span><span class="comment"> * user is straightforward.</span></div>
<div class="line"><a id="l00341" name="l00341"></a><span class="lineno">  341</span><span class="comment"> *</span></div>
<div class="line"><a id="l00342" name="l00342"></a><span class="lineno">  342</span><span class="comment"> * ### A particular trick explained ###</span></div>
<div class="line"><a id="l00343" name="l00343"></a><span class="lineno">  343</span><span class="comment"> * In C++17 fold expressions are available (https://en.cppreference.com/w/cpp/language/fold), and we use them</span></div>
<div class="line"><a id="l00344" name="l00344"></a><span class="lineno">  344</span><span class="comment"> * to create compile-time loops without the appalling coding/maintenance overhead of the meta-recursive pattern.</span></div>
<div class="line"><a id="l00345" name="l00345"></a><span class="lineno">  345</span><span class="comment"> * (This replaces a much uglier trick involving a dummy `int[]` initializer, though that was still superior to</span></div>
<div class="line"><a id="l00346" name="l00346"></a><span class="lineno">  346</span><span class="comment"> * doing the meta-recursive thing all over the place.)</span></div>
<div class="line"><a id="l00347" name="l00347"></a><span class="lineno">  347</span><span class="comment"> *</span></div>
<div class="line"><a id="l00348" name="l00348"></a><span class="lineno">  348</span><span class="comment"> * Suppose, say, you want to call `f&lt;Value_set&gt;(idx, dyn_else_st)`,</span></div>
<div class="line"><a id="l00349" name="l00349"></a><span class="lineno">  349</span><span class="comment"> * where `idx` runs through [0, #S_N_VALUE_SETS), while `dyn_else_st` alternates between `false` (static) and</span></div>
<div class="line"><a id="l00350" name="l00350"></a><span class="lineno">  350</span><span class="comment"> * `true` (dynamic).  E.g., `f()` might parse the `idx`th slot of #m_s_d_opt_sets and do something extra if it&#39;s</span></div>
<div class="line"><a id="l00351" name="l00351"></a><span class="lineno">  351</span><span class="comment"> * an odd (dynamic) slot.  Note `f()` is a template parameterized on `Value_set`.  Then:</span></div>
<div class="line"><a id="l00352" name="l00352"></a><span class="lineno">  352</span><span class="comment"> *</span></div>
<div class="line"><a id="l00353" name="l00353"></a><span class="lineno">  353</span><span class="comment"> *   ~~~</span></div>
<div class="line"><a id="l00354" name="l00354"></a><span class="lineno">  354</span><span class="comment"> *   size_t idx = 0;</span></div>
<div class="line"><a id="l00355" name="l00355"></a><span class="lineno">  355</span><span class="comment"> *   bool dyn_else_st = false;</span></div>
<div class="line"><a id="l00356" name="l00356"></a><span class="lineno">  356</span><span class="comment"> *   (</span></div>
<div class="line"><a id="l00357" name="l00357"></a><span class="lineno">  357</span><span class="comment"> *     ..., // This indicates the entire (..., expr) is a fold-expression, where...</span></div>
<div class="line"><a id="l00358" name="l00358"></a><span class="lineno">  358</span><span class="comment"> *     (</span></div>
<div class="line"><a id="l00359" name="l00359"></a><span class="lineno">  359</span><span class="comment"> *       // ...the `S_d_value_set` in the following expression is the kernel of the param-pack expansion;</span></div>
<div class="line"><a id="l00360" name="l00360"></a><span class="lineno">  360</span><span class="comment"> *       // due to the fact the class template is: template&lt;typename... S_d_value_set&gt; class Config_manager</span></div>
<div class="line"><a id="l00361" name="l00361"></a><span class="lineno">  361</span><span class="comment"> *       f&lt;S_d_value_set&gt;(idx, dyn_else_st),</span></div>
<div class="line"><a id="l00362" name="l00362"></a><span class="lineno">  362</span><span class="comment"> *       ++idx,</span></div>
<div class="line"><a id="l00363" name="l00363"></a><span class="lineno">  363</span><span class="comment"> *       dyn_else_st = !dyn_else_st)</span></div>
<div class="line"><a id="l00364" name="l00364"></a><span class="lineno">  364</span><span class="comment"> *     )</span></div>
<div class="line"><a id="l00365" name="l00365"></a><span class="lineno">  365</span><span class="comment"> *   );</span></div>
<div class="line"><a id="l00366" name="l00366"></a><span class="lineno">  366</span><span class="comment"> *   ~~~</span></div>
<div class="line"><a id="l00367" name="l00367"></a><span class="lineno">  367</span><span class="comment"> *</span></div>
<div class="line"><a id="l00368" name="l00368"></a><span class="lineno">  368</span><span class="comment"> * `(..., expr)` expands to, ultimately, `(expr1, expr2, ..., expr3)`, where each `expr...i...` is `expr` with</span></div>
<div class="line"><a id="l00369" name="l00369"></a><span class="lineno">  369</span><span class="comment"> * the i-th `S_d_value_set`.  In our case `expr...i...` is itself a comma-expression with 3 sub-expressions.</span></div>
<div class="line"><a id="l00370" name="l00370"></a><span class="lineno">  370</span><span class="comment"> * Comma-expression evaluates left-to-right, so at runtime the side effects of each</span></div>
<div class="line"><a id="l00371" name="l00371"></a><span class="lineno">  371</span><span class="comment"> * `expr...i...` are occurring at runtime; in this case this includes incrementing `idx` and repeatedly flipping</span></div>
<div class="line"><a id="l00372" name="l00372"></a><span class="lineno">  372</span><span class="comment"> * `dyn_else_st`.</span></div>
<div class="line"><a id="l00373" name="l00373"></a><span class="lineno">  373</span><span class="comment"> *</span></div>
<div class="line"><a id="l00374" name="l00374"></a><span class="lineno">  374</span><span class="comment"> * In the actual code, often we don&#39;t (just) call some helper `f&lt;&gt;()` but rather actually perform some steps in-line</span></div>
<div class="line"><a id="l00375" name="l00375"></a><span class="lineno">  375</span><span class="comment"> * there instead -- similarly to how this example does a couple of simple expressions after calling `f&lt;&gt;()`.</span></div>
<div class="line"><a id="l00376" name="l00376"></a><span class="lineno">  376</span><span class="comment"> * The good thing is the reader need not jump to another function (and all that maintenance overhead).  The bad thing</span></div>
<div class="line"><a id="l00377" name="l00377"></a><span class="lineno">  377</span><span class="comment"> * is the language constructions within an expression in C++ (not a functional language) are limited.  Loops aren&#39;t</span></div>
<div class="line"><a id="l00378" name="l00378"></a><span class="lineno">  378</span><span class="comment"> * possible; `if ()`s have to be replaced by `?:` ternaries or `&amp;&amp;` or `||` expressions; and so on.</span></div>
<div class="line"><a id="l00379" name="l00379"></a><span class="lineno">  379</span><span class="comment"> * It&#39;s not always the most readable thing, if one isn&#39;t used to it, but the author feels it&#39;s doable to get used to it,</span></div>
<div class="line"><a id="l00380" name="l00380"></a><span class="lineno">  380</span><span class="comment"> * and it&#39;s worth it for the brevity.</span></div>
<div class="line"><a id="l00381" name="l00381"></a><span class="lineno">  381</span><span class="comment"> */</span></div>
<div class="line"><a id="l00382" name="l00382"></a><span class="lineno">  382</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l00383" name="l00383"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html">  383</a></span><span class="keyword">class </span><a class="code hl_class" href="classflow_1_1cfg_1_1Config__manager.html">Config_manager</a> :</div>
<div class="line"><a id="l00384" name="l00384"></a><span class="lineno">  384</span>  <span class="keyword">public</span> <a class="code hl_class" href="classflow_1_1log_1_1Log__context.html">log::Log_context</a></div>
<div class="line"><a id="l00385" name="l00385"></a><span class="lineno">  385</span>{</div>
<div class="line"><a id="l00386" name="l00386"></a><span class="lineno">  386</span><span class="keyword">public</span>:</div>
<div class="line"><a id="l00387" name="l00387"></a><span class="lineno">  387</span>  <span class="comment">// Types.</span></div>
<div class="line"><a id="l00388" name="l00388"></a><span class="lineno">  388</span><span class="comment"></span> </div>
<div class="line"><a id="l00389" name="l00389"></a><span class="lineno">  389</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00390" name="l00390"></a><span class="lineno">  390</span><span class="comment">   * Tag type: indicates an `apply_*()` method must *allow* invalid defaults and only complain if the config source</span></div>
<div class="line"><a id="l00391" name="l00391"></a><span class="lineno">  391</span><span class="comment">   * does not explicitly supply a valid value.  Otherwise the defaults themselves are also stringently checked</span></div>
<div class="line"><a id="l00392" name="l00392"></a><span class="lineno">  392</span><span class="comment">   * regardless of whether they are overridden.  This setting applies only to individual-option-validators.</span></div>
<div class="line"><a id="l00393" name="l00393"></a><span class="lineno">  393</span><span class="comment">   * Final_validator_func validation is orthogonal to this.</span></div>
<div class="line"><a id="l00394" name="l00394"></a><span class="lineno">  394</span><span class="comment">   */</span></div>
<div class="line"><a id="l00395" name="l00395"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a6768eb0c92bd11fd84986058903b10d4">  395</a></span>  <span class="keyword">enum</span> <a class="code hl_enumeration" href="classflow_1_1cfg_1_1Config__manager.html#a6768eb0c92bd11fd84986058903b10d4">allow_invalid_defaults_tag_t</a></div>
<div class="line"><a id="l00396" name="l00396"></a><span class="lineno">  396</span>  {</div>
<div class="line"><a id="l00397" name="l00397"></a><span class="lineno">  397</span>    <a class="code hl_enumvalue" href="classflow_1_1cfg_1_1Config__manager.html#a6768eb0c92bd11fd84986058903b10d4a7ea4d19303bcf5de0947176d9637a9ed">S_ALLOW_INVALID_DEFAULTS</a> <span class="comment">///&lt; Sole value for tag type #allow_invalid_defaults_tag_t.</span></div>
<div class="line"><a id="l00398" name="l00398"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a6768eb0c92bd11fd84986058903b10d4a7ea4d19303bcf5de0947176d9637a9ed">  398</a></span>  };</div>
<div class="line"><a id="l00399" name="l00399"></a><span class="lineno">  399</span><span class="comment"></span> </div>
<div class="line"><a id="l00400" name="l00400"></a><span class="lineno">  400</span><span class="comment">  /// Short-hand for a callback to execute on dynamic config change.</span></div>
<div class="line"><a id="l00401" name="l00401"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#ab501967b40259c1a29264af1ad17baf2">  401</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_class" href="classflow_1_1Function.html">On_dynamic_change_func</a> = <a class="code hl_class" href="classflow_1_1Function.html">Function</a>&lt;void ()&gt;;</div>
<div class="line"><a id="l00402" name="l00402"></a><span class="lineno">  402</span> </div>
<div class="line"><a id="l00403" name="l00403"></a><span class="lineno">  403</span>  <span class="keyword">struct </span><a class="code hl_struct" href="structflow_1_1cfg_1_1Config__manager_1_1On__dynamic__change__func__handle.html">On_dynamic_change_func_handle</a>;</div>
<div class="line"><a id="l00404" name="l00404"></a><span class="lineno">  404</span> </div>
<div class="line"><a id="l00405" name="l00405"></a><span class="lineno">  405</span>  <span class="comment">// Constants.</span></div>
<div class="line"><a id="l00406" name="l00406"></a><span class="lineno">  406</span><span class="comment"></span> </div>
<div class="line"><a id="l00407" name="l00407"></a><span class="lineno">  407</span><span class="comment">  /// The number of template params in this Config_manager instantiation.  It must be even and positive.</span></div>
<div class="line"><a id="l00408" name="l00408"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#ad49d54a2ae34b14c276cf3de05c3c4f8">  408</a></span><span class="comment"></span>  <span class="keyword">static</span> <span class="keyword">constexpr</span> <span class="keywordtype">size_t</span> <a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#ad49d54a2ae34b14c276cf3de05c3c4f8">S_N_VALUE_SETS</a> = <span class="keyword">sizeof</span>...(S_d_value_set);</div>
<div class="line"><a id="l00409" name="l00409"></a><span class="lineno">  409</span> </div>
<div class="line"><a id="l00410" name="l00410"></a><span class="lineno">  410</span>  <span class="keyword">static_assert</span>((<a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#ad49d54a2ae34b14c276cf3de05c3c4f8">S_N_VALUE_SETS</a> % 2) == 0,</div>
<div class="line"><a id="l00411" name="l00411"></a><span class="lineno">  411</span>                <span class="stringliteral">&quot;Must have even number of template args to Config_manager; use a trailing Null_value_set if needed.&quot;</span>);<span class="comment"></span></div>
<div class="line"><a id="l00412" name="l00412"></a><span class="lineno">  412</span><span class="comment">  /// The number of static value sets (including any `Null_value_set`s).</span></div>
<div class="line"><a id="l00413" name="l00413"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a9c07f711e98435d00420277f1c20be75">  413</a></span><span class="comment"></span>  <span class="keyword">static</span> <span class="keyword">constexpr</span> <span class="keywordtype">size_t</span> <a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#a9c07f711e98435d00420277f1c20be75">S_N_S_VALUE_SETS</a> = <span class="keyword">sizeof</span>...(S_d_value_set) / 2;<span class="comment"></span></div>
<div class="line"><a id="l00414" name="l00414"></a><span class="lineno">  414</span><span class="comment">  /// The number of dynamic value sets (including any `Null_value_set`s).</span></div>
<div class="line"><a id="l00415" name="l00415"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#ac26c2d6efe1670e940badccb3fdea609">  415</a></span><span class="comment"></span>  <span class="keyword">static</span> <span class="keyword">constexpr</span> <span class="keywordtype">size_t</span> <a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#ac26c2d6efe1670e940badccb3fdea609">S_N_D_VALUE_SETS</a> = <span class="keyword">sizeof</span>...(S_d_value_set) / 2;</div>
<div class="line"><a id="l00416" name="l00416"></a><span class="lineno">  416</span> </div>
<div class="line"><a id="l00417" name="l00417"></a><span class="lineno">  417</span>  <span class="comment">// Constructors/destructor.</span></div>
<div class="line"><a id="l00418" name="l00418"></a><span class="lineno">  418</span><span class="comment"></span> </div>
<div class="line"><a id="l00419" name="l00419"></a><span class="lineno">  419</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00420" name="l00420"></a><span class="lineno">  420</span><span class="comment">   * Constructs a Config_manager ready to read initial config via `apply_*()` and other setup methods; and further</span></div>
<div class="line"><a id="l00421" name="l00421"></a><span class="lineno">  421</span><span class="comment">   * capable of both static and dynamic config.  See class doc header for class life cycle instructions.</span></div>
<div class="line"><a id="l00422" name="l00422"></a><span class="lineno">  422</span><span class="comment">   *</span></div>
<div class="line"><a id="l00423" name="l00423"></a><span class="lineno">  423</span><span class="comment">   * ### Logging assumption ###</span></div>
<div class="line"><a id="l00424" name="l00424"></a><span class="lineno">  424</span><span class="comment">   * `*logger_ptr` is a standard logging arg.  Note, though, that the class will assume that log verbosity may not have</span></div>
<div class="line"><a id="l00425" name="l00425"></a><span class="lineno">  425</span><span class="comment">   * yet been configured -- since this Config_manager may be the thing configuring it.  Informal recommendations:</span></div>
<div class="line"><a id="l00426" name="l00426"></a><span class="lineno">  426</span><span class="comment">   *   - You should let through INFO and WARNING messages in `*logger_ptr`.</span></div>
<div class="line"><a id="l00427" name="l00427"></a><span class="lineno">  427</span><span class="comment">   *   - If you plan to use `*this` only for log_help() (such as in your `--help` implementation), you should</span></div>
<div class="line"><a id="l00428" name="l00428"></a><span class="lineno">  428</span><span class="comment">   *     *not* let through TRACE-or-more-verbose.</span></div>
<div class="line"><a id="l00429" name="l00429"></a><span class="lineno">  429</span><span class="comment">   *   - Once (and if) you engage any actual parsing (apply_static(), etc.), TRACE may be helpful</span></div>
<div class="line"><a id="l00430" name="l00430"></a><span class="lineno">  430</span><span class="comment">   *     in debugging as usual.</span></div>
<div class="line"><a id="l00431" name="l00431"></a><span class="lineno">  431</span><span class="comment">   *</span></div>
<div class="line"><a id="l00432" name="l00432"></a><span class="lineno">  432</span><span class="comment">   * @param logger_ptr</span></div>
<div class="line"><a id="l00433" name="l00433"></a><span class="lineno">  433</span><span class="comment">   *        Logger to use for subsequently logging.</span></div>
<div class="line"><a id="l00434" name="l00434"></a><span class="lineno">  434</span><span class="comment">   * @param nickname</span></div>
<div class="line"><a id="l00435" name="l00435"></a><span class="lineno">  435</span><span class="comment">   *        Brief string used for logging subsequently.</span></div>
<div class="line"><a id="l00436" name="l00436"></a><span class="lineno">  436</span><span class="comment">   * @param declare_opts_func_moved</span></div>
<div class="line"><a id="l00437" name="l00437"></a><span class="lineno">  437</span><span class="comment">   *        For each `S_d_value_set`, in order, the declare-options callback as required by</span></div>
<div class="line"><a id="l00438" name="l00438"></a><span class="lineno">  438</span><span class="comment">   *        `Option_set&lt;S_d_value_set&gt;` constructor; see its doc header for instructions.</span></div>
<div class="line"><a id="l00439" name="l00439"></a><span class="lineno">  439</span><span class="comment">   *        For each Null_value_set: use the function returned by `null_declare_opts_func()`.</span></div>
<div class="line"><a id="l00440" name="l00440"></a><span class="lineno">  440</span><span class="comment">   */</span></div>
<div class="line"><a id="l00441" name="l00441"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#ad59bfabf66e01922542629bae77508ad">  441</a></span>  <span class="keyword">explicit</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#ad59bfabf66e01922542629bae77508ad">Config_manager</a>(<a class="code hl_class" href="classflow_1_1log_1_1Logger.html">log::Logger</a>* logger_ptr, <a class="code hl_typedef" href="namespaceflow_1_1util.html#ae4dc52186797094b3040379ff19124c9">util::String_view</a> nickname,</div>
<div class="line"><a id="l00442" name="l00442"></a><span class="lineno">  442</span>                          <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Option_set&lt;S_d_value_set&gt;::Declare_options_func</a>&amp;&amp;... declare_opts_func_moved);</div>
<div class="line"><a id="l00443" name="l00443"></a><span class="lineno">  443</span> </div>
<div class="line"><a id="l00444" name="l00444"></a><span class="lineno">  444</span>  <span class="comment">// Methods.</span></div>
<div class="line"><a id="l00445" name="l00445"></a><span class="lineno">  445</span><span class="comment"></span> </div>
<div class="line"><a id="l00446" name="l00446"></a><span class="lineno">  446</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00447" name="l00447"></a><span class="lineno">  447</span><span class="comment">   * Invoke this after construction to load the permanent set of static config from config sources including</span></div>
<div class="line"><a id="l00448" name="l00448"></a><span class="lineno">  448</span><span class="comment">   * a static config file; if you are also using dynamic config, see apply_static_and_dynamic() as a *potential*</span></div>
<div class="line"><a id="l00449" name="l00449"></a><span class="lineno">  449</span><span class="comment">   * alternative.  See also apply_static() overload with #allow_invalid_defaults_tag_t tag.</span></div>
<div class="line"><a id="l00450" name="l00450"></a><span class="lineno">  450</span><span class="comment">   *</span></div>
<div class="line"><a id="l00451" name="l00451"></a><span class="lineno">  451</span><span class="comment">   * After this runs and succeeds, assuming `commit == true`, you may use static_values() and/or</span></div>
<div class="line"><a id="l00452" name="l00452"></a><span class="lineno">  452</span><span class="comment">   * all_static_values() to access the loaded values.  After this runs and succeeds, but `commit == false`,</span></div>
<div class="line"><a id="l00453" name="l00453"></a><span class="lineno">  453</span><span class="comment">   * you should call apply_static() again 1+ times, with the last such call having `commit == true` and thus</span></div>
<div class="line"><a id="l00454" name="l00454"></a><span class="lineno">  454</span><span class="comment">   * canonicalizing each progressively-built candidate `Value_set`, so that it becomes available via static_values()</span></div>
<div class="line"><a id="l00455" name="l00455"></a><span class="lineno">  455</span><span class="comment">   * and all_static_values().</span></div>
<div class="line"><a id="l00456" name="l00456"></a><span class="lineno">  456</span><span class="comment">   *</span></div>
<div class="line"><a id="l00457" name="l00457"></a><span class="lineno">  457</span><span class="comment">   * On failure returns `false`; else returns `true`.  In the former case the canonical state remains unchanged,</span></div>
<div class="line"><a id="l00458" name="l00458"></a><span class="lineno">  458</span><span class="comment">   * and any candidate built-up via preceding `commit == false` calls (if any) is discarded.  The next</span></div>
<div class="line"><a id="l00459" name="l00459"></a><span class="lineno">  459</span><span class="comment">   * `apply_*()` call begins a fresh update.</span></div>
<div class="line"><a id="l00460" name="l00460"></a><span class="lineno">  460</span><span class="comment">   *</span></div>
<div class="line"><a id="l00461" name="l00461"></a><span class="lineno">  461</span><span class="comment">   * Tip: On failure you may want to exit program with error; or you can continue knowing that</span></div>
<div class="line"><a id="l00462" name="l00462"></a><span class="lineno">  462</span><span class="comment">   * static_values() will return a reference to default values (and all_static_values() will emit pointers to</span></div>
<div class="line"><a id="l00463" name="l00463"></a><span class="lineno">  463</span><span class="comment">   * `Value_set`s with default values) according to `Value_set()` no-arg ctor (for each `Value_set`).</span></div>
<div class="line"><a id="l00464" name="l00464"></a><span class="lineno">  464</span><span class="comment">   * WARNING(s) logged given failure.</span></div>
<div class="line"><a id="l00465" name="l00465"></a><span class="lineno">  465</span><span class="comment">   *</span></div>
<div class="line"><a id="l00466" name="l00466"></a><span class="lineno">  466</span><span class="comment">   * apply_static() will *not* be tolerant of unknown option names appearing in the config source.  The reasoning</span></div>
<div class="line"><a id="l00467" name="l00467"></a><span class="lineno">  467</span><span class="comment">   * (and we might change our minds over time): It should be possible to deliver the proper set of static config</span></div>
<div class="line"><a id="l00468" name="l00468"></a><span class="lineno">  468</span><span class="comment">   * along with the binary that supports it.  However apply_static_and_dynamic() is tolerant of unknown option names.</span></div>
<div class="line"><a id="l00469" name="l00469"></a><span class="lineno">  469</span><span class="comment">   *</span></div>
<div class="line"><a id="l00470" name="l00470"></a><span class="lineno">  470</span><span class="comment">   * You must supply exactly #S_N_S_VALUE_SETS `final_validator_func`s.  The compiler will likely require you to</span></div>
<div class="line"><a id="l00471" name="l00471"></a><span class="lineno">  471</span><span class="comment">   * explicitly specify the `struct` types as explicit template args; e.g:</span></div>
<div class="line"><a id="l00472" name="l00472"></a><span class="lineno">  472</span><span class="comment">   *</span></div>
<div class="line"><a id="l00473" name="l00473"></a><span class="lineno">  473</span><span class="comment">   *   ~~~</span></div>
<div class="line"><a id="l00474" name="l00474"></a><span class="lineno">  474</span><span class="comment">   *   Config_manager&lt;S_config1, D_config1, S_config2, D_config2, Null_value_set, D_config3&gt; cfg_mgr(...);</span></div>
<div class="line"><a id="l00475" name="l00475"></a><span class="lineno">  475</span><span class="comment">   *   // Explicitly specify the static config struct types.  Provide that number of final-validate functions.</span></div>
<div class="line"><a id="l00476" name="l00476"></a><span class="lineno">  476</span><span class="comment">   *   // Use null_final_validator_func() for the dummy Null_value_set in particular.</span></div>
<div class="line"><a id="l00477" name="l00477"></a><span class="lineno">  477</span><span class="comment">   *   cfg_mgr.apply_static&lt;S_config1, S_config2, Null_value_set&gt;</span></div>
<div class="line"><a id="l00478" name="l00478"></a><span class="lineno">  478</span><span class="comment">   *     (file_path, &amp;s_decl_opts1, &amp;s_decl_opts2, null_final_validator_func());</span></div>
<div class="line"><a id="l00479" name="l00479"></a><span class="lineno">  479</span><span class="comment">   *   ~~~</span></div>
<div class="line"><a id="l00480" name="l00480"></a><span class="lineno">  480</span><span class="comment">   *</span></div>
<div class="line"><a id="l00481" name="l00481"></a><span class="lineno">  481</span><span class="comment">   * For context w/r/t `commit` arg: Please read the section of the class doc header regarding multi-source</span></div>
<div class="line"><a id="l00482" name="l00482"></a><span class="lineno">  482</span><span class="comment">   * updates.  Corner case note: Formally: invoking `apply_Y()` immediately after `apply_X(commit = false) == true`,</span></div>
<div class="line"><a id="l00483" name="l00483"></a><span class="lineno">  483</span><span class="comment">   * without reject_candidates() between them, where Y and X differ =&gt; `apply_Y()` shall log an INFO message</span></div>
<div class="line"><a id="l00484" name="l00484"></a><span class="lineno">  484</span><span class="comment">   * and invoke reject_candidates() itself; then proceed.  In this case `apply_Y()` is apply_static().</span></div>
<div class="line"><a id="l00485" name="l00485"></a><span class="lineno">  485</span><span class="comment">   * Informally we discourage doing this; it is stylistically better to invoke reject_candidates()</span></div>
<div class="line"><a id="l00486" name="l00486"></a><span class="lineno">  486</span><span class="comment">   * explicitly in that scenario which cancels an in-progress update which is unusual though conceivably useful.</span></div>
<div class="line"><a id="l00487" name="l00487"></a><span class="lineno">  487</span><span class="comment">   *</span></div>
<div class="line"><a id="l00488" name="l00488"></a><span class="lineno">  488</span><span class="comment">   * ### Effect of a validator yielding SKIP ###</span></div>
<div class="line"><a id="l00489" name="l00489"></a><span class="lineno">  489</span><span class="comment">   * Consider `Value_set`s in their order of declaration, V1, V2, ....  If any one of them fails individual</span></div>
<div class="line"><a id="l00490" name="l00490"></a><span class="lineno">  490</span><span class="comment">   * option validation, or its `final_validator_func()` yields FAIL, then we return `false`</span></div>
<div class="line"><a id="l00491" name="l00491"></a><span class="lineno">  491</span><span class="comment">   * indicating this entire update has failed.  If all parsed fine, and `final_validator_func()` yielded ACCEPT for all,</span></div>
<div class="line"><a id="l00492" name="l00492"></a><span class="lineno">  492</span><span class="comment">   * then we return `true`, indicating this update is successful (so far at least, depending on `commit`).</span></div>
<div class="line"><a id="l00493" name="l00493"></a><span class="lineno">  493</span><span class="comment">   *</span></div>
<div class="line"><a id="l00494" name="l00494"></a><span class="lineno">  494</span><span class="comment">   * Now consider the situation where for `Value_set` Vi, `final_validator_func()` yielded SKIP, while all</span></div>
<div class="line"><a id="l00495" name="l00495"></a><span class="lineno">  495</span><span class="comment">   * Vj before Vi yielded SUCCESS.</span></div>
<div class="line"><a id="l00496" name="l00496"></a><span class="lineno">  496</span><span class="comment">   *</span></div>
<div class="line"><a id="l00497" name="l00497"></a><span class="lineno">  497</span><span class="comment">   * Effect 1: The parsed values for that `Value_set` Vi shall be ignored, as-if they were equal to the cumulative</span></div>
<div class="line"><a id="l00498" name="l00498"></a><span class="lineno">  498</span><span class="comment">   * values built in preceding files in this update (or to the baseline values, if this is the first or only</span></div>
<div class="line"><a id="l00499" name="l00499"></a><span class="lineno">  499</span><span class="comment">   * file in this update).</span></div>
<div class="line"><a id="l00500" name="l00500"></a><span class="lineno">  500</span><span class="comment">   *</span></div>
<div class="line"><a id="l00501" name="l00501"></a><span class="lineno">  501</span><span class="comment">   * Effect 2: The same shall hold for *each* `Value_set` Vj *after* Vi: They will not be parsed; they will not be</span></div>
<div class="line"><a id="l00502" name="l00502"></a><span class="lineno">  502</span><span class="comment">   * validated; their `final_validator_func()` shall not be executed; and they shall ignored, as-if they were equal</span></div>
<div class="line"><a id="l00503" name="l00503"></a><span class="lineno">  503</span><span class="comment">   * to the cumulative values built in preceding files in this update (or to the baseline values, if this is the</span></div>
<div class="line"><a id="l00504" name="l00504"></a><span class="lineno">  504</span><span class="comment">   * first or only file in this update).  So, if (e.g.) V2 is the first `Value_set` to yield SKIP, then</span></div>
<div class="line"><a id="l00505" name="l00505"></a><span class="lineno">  505</span><span class="comment">   * it&#39;s as-if V2, V3, ... also yielded SKIP (conceptually speaking) -- to the point where their values in</span></div>
<div class="line"><a id="l00506" name="l00506"></a><span class="lineno">  506</span><span class="comment">   * the source are ignored entirely.</span></div>
<div class="line"><a id="l00507" name="l00507"></a><span class="lineno">  507</span><span class="comment">   *</span></div>
<div class="line"><a id="l00508" name="l00508"></a><span class="lineno">  508</span><span class="comment">   * @note Each `final_validator_func()` can be made quite brief by using convenience macro</span></div>
<div class="line"><a id="l00509" name="l00509"></a><span class="lineno">  509</span><span class="comment">   *       FLOW_CFG_OPT_CHECK_ASSERT().  This will take care of most logging in most cases.</span></div>
<div class="line"><a id="l00510" name="l00510"></a><span class="lineno">  510</span><span class="comment">   * @note For each Null_value_set: use `final_validator_func = null_final_validator_func()`.</span></div>
<div class="line"><a id="l00511" name="l00511"></a><span class="lineno">  511</span><span class="comment">   * @note A validator function will not be run if there is a failure to parse any preceding `Value_set` (including a</span></div>
<div class="line"><a id="l00512" name="l00512"></a><span class="lineno">  512</span><span class="comment">   *       failure of its associated validator function).</span></div>
<div class="line"><a id="l00513" name="l00513"></a><span class="lineno">  513</span><span class="comment">   * @note A validator function may rely on all_static_values_candidates() and static_values_candidate() providing the</span></div>
<div class="line"><a id="l00514" name="l00514"></a><span class="lineno">  514</span><span class="comment">   *       parsed (and validated) values candidate for any preceding static value set.</span></div>
<div class="line"><a id="l00515" name="l00515"></a><span class="lineno">  515</span><span class="comment">   *</span></div>
<div class="line"><a id="l00516" name="l00516"></a><span class="lineno">  516</span><span class="comment">   * @todo Add support for command line as a config source in addition to file(s), for static config in</span></div>
<div class="line"><a id="l00517" name="l00517"></a><span class="lineno">  517</span><span class="comment">   * cfg::Config_manager and cfg::Static_config_manager.</span></div>
<div class="line"><a id="l00518" name="l00518"></a><span class="lineno">  518</span><span class="comment">   *</span></div>
<div class="line"><a id="l00519" name="l00519"></a><span class="lineno">  519</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l00520" name="l00520"></a><span class="lineno">  520</span><span class="comment">   *         These must be `S_d_value_set` template param pack args 0, 2, ..., numbering</span></div>
<div class="line"><a id="l00521" name="l00521"></a><span class="lineno">  521</span><span class="comment">   *         #S_N_S_VALUE_SETS in order.</span></div>
<div class="line"><a id="l00522" name="l00522"></a><span class="lineno">  522</span><span class="comment">   * @param static_cfg_path</span></div>
<div class="line"><a id="l00523" name="l00523"></a><span class="lineno">  523</span><span class="comment">   *        File to read.</span></div>
<div class="line"><a id="l00524" name="l00524"></a><span class="lineno">  524</span><span class="comment">   * @param final_validator_func</span></div>
<div class="line"><a id="l00525" name="l00525"></a><span class="lineno">  525</span><span class="comment">   *        For each arg:</span></div>
<div class="line"><a id="l00526" name="l00526"></a><span class="lineno">  526</span><span class="comment">   *        If parsing and individual-option-validation succeed, the method shall return success if</span></div>
<div class="line"><a id="l00527" name="l00527"></a><span class="lineno">  527</span><span class="comment">   *        `final_validator_func(V)` returns Final_validator_outcome::S_ACCEPT or Final_validator_outcome::S_SKIP,</span></div>
<div class="line"><a id="l00528" name="l00528"></a><span class="lineno">  528</span><span class="comment">   *        where V is the parsed `Value_set`.  (If `apply_static(commit = false) == true` call(s) preceded this</span></div>
<div class="line"><a id="l00529" name="l00529"></a><span class="lineno">  529</span><span class="comment">   *        one, V is the cumulative candidate from such call(s) so far, plus values parsed from</span></div>
<div class="line"><a id="l00530" name="l00530"></a><span class="lineno">  530</span><span class="comment">   *        `static_cfg_path` on top of that.)</span></div>
<div class="line"><a id="l00531" name="l00531"></a><span class="lineno">  531</span><span class="comment">   *        Informally: Please place individual-option validation</span></div>
<div class="line"><a id="l00532" name="l00532"></a><span class="lineno">  532</span><span class="comment">   *        into FLOW_CFG_OPTION_SET_DECLARE_OPTION() invocations; only use `final_validator_func()` for</span></div>
<div class="line"><a id="l00533" name="l00533"></a><span class="lineno">  533</span><span class="comment">   *        internal consistency checks (if any) and skip conditions (if any).</span></div>
<div class="line"><a id="l00534" name="l00534"></a><span class="lineno">  534</span><span class="comment">   *        Plus: if a `final_validatar_func()` for a particular `Value_set` returns `S_SKIP`, then</span></div>
<div class="line"><a id="l00535" name="l00535"></a><span class="lineno">  535</span><span class="comment">   *        the subsequent ones will not run (nor will those subsequent `Value_set`s be parsed or individually</span></div>
<div class="line"><a id="l00536" name="l00536"></a><span class="lineno">  536</span><span class="comment">   *        validated).</span></div>
<div class="line"><a id="l00537" name="l00537"></a><span class="lineno">  537</span><span class="comment">   * @param commit</span></div>
<div class="line"><a id="l00538" name="l00538"></a><span class="lineno">  538</span><span class="comment">   *        `true` means that this call being successful (returning `true`) shall cause the promotion of</span></div>
<div class="line"><a id="l00539" name="l00539"></a><span class="lineno">  539</span><span class="comment">   *        each candidate `Value_set` built-up so far (via this call and all preceding successful calls with</span></div>
<div class="line"><a id="l00540" name="l00540"></a><span class="lineno">  540</span><span class="comment">   *        `commit == false`) to canonical state (accessed via static_values() or all_static_values()).</span></div>
<div class="line"><a id="l00541" name="l00541"></a><span class="lineno">  541</span><span class="comment">   *        `false` means that this call being successful shall merely create-and-set (if first such call)</span></div>
<div class="line"><a id="l00542" name="l00542"></a><span class="lineno">  542</span><span class="comment">   *        or incrementally update (if 2nd, 3rd, ... such call) each candidate `Value_set`.</span></div>
<div class="line"><a id="l00543" name="l00543"></a><span class="lineno">  543</span><span class="comment">   * @return `true` if and only if successfully parsed config source and validated all settings including</span></div>
<div class="line"><a id="l00544" name="l00544"></a><span class="lineno">  544</span><span class="comment">   *         `final_validator_func() != S_FAIL` for *all* (static) config sets; and defaults were also all individually</span></div>
<div class="line"><a id="l00545" name="l00545"></a><span class="lineno">  545</span><span class="comment">   *         valid.  However, if `true` but `commit == false`, then the canonical values</span></div>
<div class="line"><a id="l00546" name="l00546"></a><span class="lineno">  546</span><span class="comment">   *         (accessed via static_values() or all_static_values()) have not been updated.</span></div>
<div class="line"><a id="l00547" name="l00547"></a><span class="lineno">  547</span><span class="comment">   *         If `false` with `commit == false`, you should not call apply_static() for the planned</span></div>
<div class="line"><a id="l00548" name="l00548"></a><span class="lineno">  548</span><span class="comment">   *         subsequent config sources: this update has failed, and any built-up candidate `Value_set`s are</span></div>
<div class="line"><a id="l00549" name="l00549"></a><span class="lineno">  549</span><span class="comment">   *         discarded.</span></div>
<div class="line"><a id="l00550" name="l00550"></a><span class="lineno">  550</span><span class="comment">   */</span></div>
<div class="line"><a id="l00551" name="l00551"></a><span class="lineno">  551</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l00552" name="l00552"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a22bfec8082d0c7b5dff9ee7e98865707">  552</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a22bfec8082d0c7b5dff9ee7e98865707">apply_static</a>(<span class="keyword">const</span> fs::path&amp; static_cfg_path,</div>
<div class="line"><a id="l00553" name="l00553"></a><span class="lineno">  553</span>                    <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;Value_set&gt;::Type</a>&amp;... final_validator_func,</div>
<div class="line"><a id="l00554" name="l00554"></a><span class="lineno">  554</span>                    <span class="keywordtype">bool</span> commit = <span class="keyword">true</span>);</div>
<div class="line"><a id="l00555" name="l00555"></a><span class="lineno">  555</span><span class="comment"></span> </div>
<div class="line"><a id="l00556" name="l00556"></a><span class="lineno">  556</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00557" name="l00557"></a><span class="lineno">  557</span><span class="comment">   * Identical to apply_static() overload without #allow_invalid_defaults_tag_t tag; but skips the stringent</span></div>
<div class="line"><a id="l00558" name="l00558"></a><span class="lineno">  558</span><span class="comment">   * check on individual defaults&#39; validity.</span></div>
<div class="line"><a id="l00559" name="l00559"></a><span class="lineno">  559</span><span class="comment">   *</span></div>
<div class="line"><a id="l00560" name="l00560"></a><span class="lineno">  560</span><span class="comment">   * @see #allow_invalid_defaults_tag_t doc header and/or return-value doc just below.</span></div>
<div class="line"><a id="l00561" name="l00561"></a><span class="lineno">  561</span><span class="comment">   *</span></div>
<div class="line"><a id="l00562" name="l00562"></a><span class="lineno">  562</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l00563" name="l00563"></a><span class="lineno">  563</span><span class="comment">   *         See other apply_static().</span></div>
<div class="line"><a id="l00564" name="l00564"></a><span class="lineno">  564</span><span class="comment">   * @param static_cfg_path</span></div>
<div class="line"><a id="l00565" name="l00565"></a><span class="lineno">  565</span><span class="comment">   *        See other apply_static().</span></div>
<div class="line"><a id="l00566" name="l00566"></a><span class="lineno">  566</span><span class="comment">   * @param final_validator_func</span></div>
<div class="line"><a id="l00567" name="l00567"></a><span class="lineno">  567</span><span class="comment">   *        See other apply_static().</span></div>
<div class="line"><a id="l00568" name="l00568"></a><span class="lineno">  568</span><span class="comment">   * @param commit</span></div>
<div class="line"><a id="l00569" name="l00569"></a><span class="lineno">  569</span><span class="comment">   *        See other apply_static().</span></div>
<div class="line"><a id="l00570" name="l00570"></a><span class="lineno">  570</span><span class="comment">   * @return See other apply_static().  The difference between the other `apply_static()` and this overload is:</span></div>
<div class="line"><a id="l00571" name="l00571"></a><span class="lineno">  571</span><span class="comment">   *         The other overload will return `false` given an invalid default, even if</span></div>
<div class="line"><a id="l00572" name="l00572"></a><span class="lineno">  572</span><span class="comment">   *         file `static_cfg_path` explicitly sets it to a valid value.  This tagged overload will not fail (return</span></div>
<div class="line"><a id="l00573" name="l00573"></a><span class="lineno">  573</span><span class="comment">   *         `false` for that reason) and will let parsing continue instead.</span></div>
<div class="line"><a id="l00574" name="l00574"></a><span class="lineno">  574</span><span class="comment">   */</span></div>
<div class="line"><a id="l00575" name="l00575"></a><span class="lineno">  575</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l00576" name="l00576"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#af027c6f4b595f1f8ebbd6d41ad705f5e">  576</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#af027c6f4b595f1f8ebbd6d41ad705f5e">apply_static</a>(<a class="code hl_enumeration" href="classflow_1_1cfg_1_1Config__manager.html#a6768eb0c92bd11fd84986058903b10d4">allow_invalid_defaults_tag_t</a>,</div>
<div class="line"><a id="l00577" name="l00577"></a><span class="lineno">  577</span>                    <span class="keyword">const</span> fs::path&amp; static_cfg_path,</div>
<div class="line"><a id="l00578" name="l00578"></a><span class="lineno">  578</span>                    <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;Value_set&gt;::Type</a>&amp;... final_validator_func,</div>
<div class="line"><a id="l00579" name="l00579"></a><span class="lineno">  579</span>                    <span class="keywordtype">bool</span> commit = <span class="keyword">true</span>);</div>
<div class="line"><a id="l00580" name="l00580"></a><span class="lineno">  580</span><span class="comment"></span> </div>
<div class="line"><a id="l00581" name="l00581"></a><span class="lineno">  581</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00582" name="l00582"></a><span class="lineno">  582</span><span class="comment">   * If you use dynamic config, *and* you allow for initial values for dynamic options to be read from the same file</span></div>
<div class="line"><a id="l00583" name="l00583"></a><span class="lineno">  583</span><span class="comment">   * as the static config values, then invoke this instead of apply_static().  See also apply_static_and_dynamic()</span></div>
<div class="line"><a id="l00584" name="l00584"></a><span class="lineno">  584</span><span class="comment">   * overload with #allow_invalid_defaults_tag_t tag.</span></div>
<div class="line"><a id="l00585" name="l00585"></a><span class="lineno">  585</span><span class="comment">   *</span></div>
<div class="line"><a id="l00586" name="l00586"></a><span class="lineno">  586</span><span class="comment">   * With static config-only use case:</span></div>
<div class="line"><a id="l00587" name="l00587"></a><span class="lineno">  587</span><span class="comment">   *   - Just apply_static().</span></div>
<div class="line"><a id="l00588" name="l00588"></a><span class="lineno">  588</span><span class="comment">   *   - Then static_values() / all_static_values() whenever needed.</span></div>
<div class="line"><a id="l00589" name="l00589"></a><span class="lineno">  589</span><span class="comment">   *</span></div>
<div class="line"><a id="l00590" name="l00590"></a><span class="lineno">  590</span><span class="comment">   * With dynamic-and-static config use case, *with* allowing baseline dynamic values to be set in static config</span></div>
<div class="line"><a id="l00591" name="l00591"></a><span class="lineno">  591</span><span class="comment">   * file:</span></div>
<div class="line"><a id="l00592" name="l00592"></a><span class="lineno">  592</span><span class="comment">   *   - apply_static_and_dynamic(). &lt;-- ATTN</span></div>
<div class="line"><a id="l00593" name="l00593"></a><span class="lineno">  593</span><span class="comment">   *   - Initial apply_dynamic().  (Typically it is allowed that there is no dynamic config file present yet though.)</span></div>
<div class="line"><a id="l00594" name="l00594"></a><span class="lineno">  594</span><span class="comment">   *   - Then static_values() / all_static_values(), dynamic_values() / all_dynamic_values() whenever needed.</span></div>
<div class="line"><a id="l00595" name="l00595"></a><span class="lineno">  595</span><span class="comment">   *     - Further apply_dynamic(), if dynamic config source(s) may have changed.</span></div>
<div class="line"><a id="l00596" name="l00596"></a><span class="lineno">  596</span><span class="comment">   *</span></div>
<div class="line"><a id="l00597" name="l00597"></a><span class="lineno">  597</span><span class="comment">   * With dynamic-and-static config use case, *without* allowing baseline dynamic values to be set in static config</span></div>
<div class="line"><a id="l00598" name="l00598"></a><span class="lineno">  598</span><span class="comment">   * file:</span></div>
<div class="line"><a id="l00599" name="l00599"></a><span class="lineno">  599</span><span class="comment">   *   - apply_static().</span></div>
<div class="line"><a id="l00600" name="l00600"></a><span class="lineno">  600</span><span class="comment">   *   - Initial apply_dynamic().</span></div>
<div class="line"><a id="l00601" name="l00601"></a><span class="lineno">  601</span><span class="comment">   *   - Then static_values() / all_static_values(), dynamic_values() / all_dynamic_values() whenever needed.</span></div>
<div class="line"><a id="l00602" name="l00602"></a><span class="lineno">  602</span><span class="comment">   *     - Further apply_dynamic(), if dynamic config source(s) may have changed.</span></div>
<div class="line"><a id="l00603" name="l00603"></a><span class="lineno">  603</span><span class="comment">   *</span></div>
<div class="line"><a id="l00604" name="l00604"></a><span class="lineno">  604</span><span class="comment">   * On failure returns `false`; else returns `true`.  In the former case the canonical state remains unchanged,</span></div>
<div class="line"><a id="l00605" name="l00605"></a><span class="lineno">  605</span><span class="comment">   * and any candidate built-up via preceding `commit == false` calls (if any) is discarded.  WARNING(s) logged</span></div>
<div class="line"><a id="l00606" name="l00606"></a><span class="lineno">  606</span><span class="comment">   * given failure.</span></div>
<div class="line"><a id="l00607" name="l00607"></a><span class="lineno">  607</span><span class="comment">   *</span></div>
<div class="line"><a id="l00608" name="l00608"></a><span class="lineno">  608</span><span class="comment">   * For context w/r/t `commit` arg: Please read the section of the class doc header regarding multi-source</span></div>
<div class="line"><a id="l00609" name="l00609"></a><span class="lineno">  609</span><span class="comment">   * updates.  Corner case note: Formally: invoking `apply_Y()` immediately after `apply_X(commit = false) == true`,</span></div>
<div class="line"><a id="l00610" name="l00610"></a><span class="lineno">  610</span><span class="comment">   * without reject_candidates() between them, where Y and X differ =&gt; `apply_Y()` shall log an INFO message</span></div>
<div class="line"><a id="l00611" name="l00611"></a><span class="lineno">  611</span><span class="comment">   * and invoke reject_candidates() itself; then proceed.  In this case `apply_Y()` is apply_static_and_dynamic().</span></div>
<div class="line"><a id="l00612" name="l00612"></a><span class="lineno">  612</span><span class="comment">   * Informally we discourage doing this; it is stylistically better to invoke reject_candidates()</span></div>
<div class="line"><a id="l00613" name="l00613"></a><span class="lineno">  613</span><span class="comment">   * explicitly in that scenario which cancels an in-progress update which is unusual though conceivably useful.</span></div>
<div class="line"><a id="l00614" name="l00614"></a><span class="lineno">  614</span><span class="comment">   *</span></div>
<div class="line"><a id="l00615" name="l00615"></a><span class="lineno">  615</span><span class="comment">   * ### Effect of a validator yielding SKIP ###</span></div>
<div class="line"><a id="l00616" name="l00616"></a><span class="lineno">  616</span><span class="comment">   * Identical to apply_static() but across both static and dynamic `Value_set`s, in static/dynamic/static/dynamic/...</span></div>
<div class="line"><a id="l00617" name="l00617"></a><span class="lineno">  617</span><span class="comment">   * order.</span></div>
<div class="line"><a id="l00618" name="l00618"></a><span class="lineno">  618</span><span class="comment">   *</span></div>
<div class="line"><a id="l00619" name="l00619"></a><span class="lineno">  619</span><span class="comment">   * @note By definition this will not compile unless `final_validator_func` count equals #S_N_VALUE_SETS.</span></div>
<div class="line"><a id="l00620" name="l00620"></a><span class="lineno">  620</span><span class="comment">   *       However, unlike apply_static() or apply_dynamic(), there are no template args to explicitly supply.</span></div>
<div class="line"><a id="l00621" name="l00621"></a><span class="lineno">  621</span><span class="comment">   *</span></div>
<div class="line"><a id="l00622" name="l00622"></a><span class="lineno">  622</span><span class="comment">   * @param cfg_path</span></div>
<div class="line"><a id="l00623" name="l00623"></a><span class="lineno">  623</span><span class="comment">   *        File to read for both static and dynamic config.</span></div>
<div class="line"><a id="l00624" name="l00624"></a><span class="lineno">  624</span><span class="comment">   * @param final_validator_func</span></div>
<div class="line"><a id="l00625" name="l00625"></a><span class="lineno">  625</span><span class="comment">   *        See apply_static(); particularly the notes about how a validator function will not be run if there is a</span></div>
<div class="line"><a id="l00626" name="l00626"></a><span class="lineno">  626</span><span class="comment">   *        preceding failure and that all_static_values_candidates() and static_values_candidate() can be relied upon.</span></div>
<div class="line"><a id="l00627" name="l00627"></a><span class="lineno">  627</span><span class="comment">   * @param commit</span></div>
<div class="line"><a id="l00628" name="l00628"></a><span class="lineno">  628</span><span class="comment">   *        `true` means that this call being successful (returning `true`) shall cause the promotion of</span></div>
<div class="line"><a id="l00629" name="l00629"></a><span class="lineno">  629</span><span class="comment">   *        each candidate `Value_set` built-up so far (via this and all preceding successful calls with</span></div>
<div class="line"><a id="l00630" name="l00630"></a><span class="lineno">  630</span><span class="comment">   *        `commit == false`) to canonical state (accessed via `*ic_values()` or `all_*ic_values()`);</span></div>
<div class="line"><a id="l00631" name="l00631"></a><span class="lineno">  631</span><span class="comment">   *        and all dynamic change listeners are synchronously called.</span></div>
<div class="line"><a id="l00632" name="l00632"></a><span class="lineno">  632</span><span class="comment">   *        `false` means that this call being successful shall merely create-and-set (if first such call)</span></div>
<div class="line"><a id="l00633" name="l00633"></a><span class="lineno">  633</span><span class="comment">   *        or incrementally update (if 2nd, 3rd, ... such call) each candidate `Value_set`; no dynamic change</span></div>
<div class="line"><a id="l00634" name="l00634"></a><span class="lineno">  634</span><span class="comment">   *        listeners are invoked.</span></div>
<div class="line"><a id="l00635" name="l00635"></a><span class="lineno">  635</span><span class="comment">   * @return `true` if and only if successfully parsed config source(s) and validated all settings including</span></div>
<div class="line"><a id="l00636" name="l00636"></a><span class="lineno">  636</span><span class="comment">   *         `final_validator_func() != S_FAIL` for *all* (static and dynamic) config sets; and defaults were also all</span></div>
<div class="line"><a id="l00637" name="l00637"></a><span class="lineno">  637</span><span class="comment">   *         individually valid.  However, if `true` but `commit == false`, then the canonical values</span></div>
<div class="line"><a id="l00638" name="l00638"></a><span class="lineno">  638</span><span class="comment">   *         (accessed via `*ic_values()` or `*ic_values()`) have not been updated.</span></div>
<div class="line"><a id="l00639" name="l00639"></a><span class="lineno">  639</span><span class="comment">   *         If `false` with `commit == false`, you should not call apply_static_and_dynamic() for the planned</span></div>
<div class="line"><a id="l00640" name="l00640"></a><span class="lineno">  640</span><span class="comment">   *         subsequent config sources: this update has failed, and any built-up candidate `Value_set`s are</span></div>
<div class="line"><a id="l00641" name="l00641"></a><span class="lineno">  641</span><span class="comment">   *         discarded.</span></div>
<div class="line"><a id="l00642" name="l00642"></a><span class="lineno">  642</span><span class="comment">   */</span></div>
<div class="line"><a id="l00643" name="l00643"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a9d9811d1b4aab2c4ea3e6813d4161304">  643</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a9d9811d1b4aab2c4ea3e6813d4161304">apply_static_and_dynamic</a>(<span class="keyword">const</span> fs::path&amp; cfg_path,</div>
<div class="line"><a id="l00644" name="l00644"></a><span class="lineno">  644</span>                                <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;S_d_value_set&gt;::Type</a>&amp;... final_validator_func,</div>
<div class="line"><a id="l00645" name="l00645"></a><span class="lineno">  645</span>                                <span class="keywordtype">bool</span> commit = <span class="keyword">true</span>);</div>
<div class="line"><a id="l00646" name="l00646"></a><span class="lineno">  646</span><span class="comment"></span> </div>
<div class="line"><a id="l00647" name="l00647"></a><span class="lineno">  647</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00648" name="l00648"></a><span class="lineno">  648</span><span class="comment">   * Identical to apply_static_and_dynamic() overload without #allow_invalid_defaults_tag_t tag; but skips the stringent</span></div>
<div class="line"><a id="l00649" name="l00649"></a><span class="lineno">  649</span><span class="comment">   * check on individual defaults&#39; validity.</span></div>
<div class="line"><a id="l00650" name="l00650"></a><span class="lineno">  650</span><span class="comment">   *</span></div>
<div class="line"><a id="l00651" name="l00651"></a><span class="lineno">  651</span><span class="comment">   * @see #allow_invalid_defaults_tag_t doc header and/or return-value doc just below.</span></div>
<div class="line"><a id="l00652" name="l00652"></a><span class="lineno">  652</span><span class="comment">   *</span></div>
<div class="line"><a id="l00653" name="l00653"></a><span class="lineno">  653</span><span class="comment">   * @param cfg_path</span></div>
<div class="line"><a id="l00654" name="l00654"></a><span class="lineno">  654</span><span class="comment">   *        See other apply_static_and_dynamic().</span></div>
<div class="line"><a id="l00655" name="l00655"></a><span class="lineno">  655</span><span class="comment">   * @param final_validator_func</span></div>
<div class="line"><a id="l00656" name="l00656"></a><span class="lineno">  656</span><span class="comment">   *        See other apply_static_and_dynamic().</span></div>
<div class="line"><a id="l00657" name="l00657"></a><span class="lineno">  657</span><span class="comment">   * @param commit</span></div>
<div class="line"><a id="l00658" name="l00658"></a><span class="lineno">  658</span><span class="comment">   *        See other apply_static_and_dynamic().</span></div>
<div class="line"><a id="l00659" name="l00659"></a><span class="lineno">  659</span><span class="comment">   * @return See other apply_static_and_dynamic().  The difference between the other `apply_static_and_dynamic()` and</span></div>
<div class="line"><a id="l00660" name="l00660"></a><span class="lineno">  660</span><span class="comment">   *         this overload is:</span></div>
<div class="line"><a id="l00661" name="l00661"></a><span class="lineno">  661</span><span class="comment">   *         The other overload will return `false` given an invalid default, even if</span></div>
<div class="line"><a id="l00662" name="l00662"></a><span class="lineno">  662</span><span class="comment">   *         file `cfg_path` explicitly sets it to a valid value.  This tagged overload will not fail (return</span></div>
<div class="line"><a id="l00663" name="l00663"></a><span class="lineno">  663</span><span class="comment">   *         `false` for that reason) and will let parsing continue instead.</span></div>
<div class="line"><a id="l00664" name="l00664"></a><span class="lineno">  664</span><span class="comment">   */</span></div>
<div class="line"><a id="l00665" name="l00665"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a5d85fa5a1ed933c9b85444ddb9a416b1">  665</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a5d85fa5a1ed933c9b85444ddb9a416b1">apply_static_and_dynamic</a>(<a class="code hl_enumeration" href="classflow_1_1cfg_1_1Config__manager.html#a6768eb0c92bd11fd84986058903b10d4">allow_invalid_defaults_tag_t</a>,</div>
<div class="line"><a id="l00666" name="l00666"></a><span class="lineno">  666</span>                                <span class="keyword">const</span> fs::path&amp; cfg_path,</div>
<div class="line"><a id="l00667" name="l00667"></a><span class="lineno">  667</span>                                <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;S_d_value_set&gt;::Type</a>&amp;... final_validator_func,</div>
<div class="line"><a id="l00668" name="l00668"></a><span class="lineno">  668</span>                                <span class="keywordtype">bool</span> commit = <span class="keyword">true</span>);</div>
<div class="line"><a id="l00669" name="l00669"></a><span class="lineno">  669</span><span class="comment"></span> </div>
<div class="line"><a id="l00670" name="l00670"></a><span class="lineno">  670</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00671" name="l00671"></a><span class="lineno">  671</span><span class="comment">   * Load the first or subsequent set of dynamic config from config source including a dynamic config file.</span></div>
<div class="line"><a id="l00672" name="l00672"></a><span class="lineno">  672</span><span class="comment">   * If you use dynamic config: You must invoke this, or apply_static_and_dynamic(), once before access via</span></div>
<div class="line"><a id="l00673" name="l00673"></a><span class="lineno">  673</span><span class="comment">   * dynamic_values() / all_dynamic_values().  After that, optionally invoke it whenever there is good reason</span></div>
<div class="line"><a id="l00674" name="l00674"></a><span class="lineno">  674</span><span class="comment">   * to believe new dynamic config is available in the dynamic config source(s).</span></div>
<div class="line"><a id="l00675" name="l00675"></a><span class="lineno">  675</span><span class="comment">   *</span></div>
<div class="line"><a id="l00676" name="l00676"></a><span class="lineno">  676</span><span class="comment">   * See also apply_static_and_dynamic().  If not using apply_static_and_dynamic(), *and* this is the initial</span></div>
<div class="line"><a id="l00677" name="l00677"></a><span class="lineno">  677</span><span class="comment">   * apply_dynamic() invoked, then see also apply_dynamic() overload with #allow_invalid_defaults_tag_t tag.</span></div>
<div class="line"><a id="l00678" name="l00678"></a><span class="lineno">  678</span><span class="comment">   *</span></div>
<div class="line"><a id="l00679" name="l00679"></a><span class="lineno">  679</span><span class="comment">   * After the initial apply_dynamic(): It is safe to call apply_dynamic() concurrently with any number of</span></div>
<div class="line"><a id="l00680" name="l00680"></a><span class="lineno">  680</span><span class="comment">   * `[all_]dynamic_values()`.  However behavior is undefined if one calls apply_dynamic() concurrently with itself</span></div>
<div class="line"><a id="l00681" name="l00681"></a><span class="lineno">  681</span><span class="comment">   * or apply_static_and_dynamic() (on the same `*this`).</span></div>
<div class="line"><a id="l00682" name="l00682"></a><span class="lineno">  682</span><span class="comment">   *</span></div>
<div class="line"><a id="l00683" name="l00683"></a><span class="lineno">  683</span><span class="comment">   * On failure returns `false`; else returns `true`.  In the former case the canonical state remains unchanged,</span></div>
<div class="line"><a id="l00684" name="l00684"></a><span class="lineno">  684</span><span class="comment">   * and any candidate built-up via preceding `commit == false` calls (if any) is discarded.  WARNING(s) logged</span></div>
<div class="line"><a id="l00685" name="l00685"></a><span class="lineno">  685</span><span class="comment">   * given failure.</span></div>
<div class="line"><a id="l00686" name="l00686"></a><span class="lineno">  686</span><span class="comment">   *</span></div>
<div class="line"><a id="l00687" name="l00687"></a><span class="lineno">  687</span><span class="comment">   * apply_dynamic() will be tolerant of unknown option names appearing in the config source, though it will</span></div>
<div class="line"><a id="l00688" name="l00688"></a><span class="lineno">  688</span><span class="comment">   * log about them.  The reasoning: Dynamic config must grapple with backward- and forward-compatibility.</span></div>
<div class="line"><a id="l00689" name="l00689"></a><span class="lineno">  689</span><span class="comment">   *</span></div>
<div class="line"><a id="l00690" name="l00690"></a><span class="lineno">  690</span><span class="comment">   * For context w/r/t `commit` arg: Please read the section of the class doc header regarding multi-source</span></div>
<div class="line"><a id="l00691" name="l00691"></a><span class="lineno">  691</span><span class="comment">   * updates.  Corner case note: Formally: invoking `apply_Y()` immediately after `apply_X(commit = false) == true`,</span></div>
<div class="line"><a id="l00692" name="l00692"></a><span class="lineno">  692</span><span class="comment">   * without reject_candidates() between them, where Y and X differ =&gt; `apply_Y()` shall log an INFO message</span></div>
<div class="line"><a id="l00693" name="l00693"></a><span class="lineno">  693</span><span class="comment">   * and invoke reject_candidates() itself; then proceed.  In this case `apply_Y()` is apply_dynamic().</span></div>
<div class="line"><a id="l00694" name="l00694"></a><span class="lineno">  694</span><span class="comment">   * Informally we discourage doing this; it is stylistically better to invoke reject_candidates()</span></div>
<div class="line"><a id="l00695" name="l00695"></a><span class="lineno">  695</span><span class="comment">   * explicitly in that scenario which cancels an in-progress update which is unusual though conceivably useful.</span></div>
<div class="line"><a id="l00696" name="l00696"></a><span class="lineno">  696</span><span class="comment">   *</span></div>
<div class="line"><a id="l00697" name="l00697"></a><span class="lineno">  697</span><span class="comment">   * ### Effect of a validator yielding SKIP ###</span></div>
<div class="line"><a id="l00698" name="l00698"></a><span class="lineno">  698</span><span class="comment">   * Identical to apply_static().</span></div>
<div class="line"><a id="l00699" name="l00699"></a><span class="lineno">  699</span><span class="comment">   *</span></div>
<div class="line"><a id="l00700" name="l00700"></a><span class="lineno">  700</span><span class="comment">   * ### Performance ###</span></div>
<div class="line"><a id="l00701" name="l00701"></a><span class="lineno">  701</span><span class="comment">   * dynamic_values() + all_dynamic_values() locking performance is no worse than: lock mutex,</span></div>
<div class="line"><a id="l00702" name="l00702"></a><span class="lineno">  702</span><span class="comment">   * assign #S_N_D_VALUE_SETS `shared_ptr`s, unlock mutex.  The rest of the parse/validate/etc. code is outside any such</span></div>
<div class="line"><a id="l00703" name="l00703"></a><span class="lineno">  703</span><span class="comment">   * critical section.  See also Performance section of dynamic_values() doc header.</span></div>
<div class="line"><a id="l00704" name="l00704"></a><span class="lineno">  704</span><span class="comment">   *</span></div>
<div class="line"><a id="l00705" name="l00705"></a><span class="lineno">  705</span><span class="comment">   * Outside that locking critical section, apply_dynamic() may be expensive, in that it performs file input and some</span></div>
<div class="line"><a id="l00706" name="l00706"></a><span class="lineno">  706</span><span class="comment">   * internal copying of option value sets and maps, plus detailed logging.  It is, however, not typically called</span></div>
<div class="line"><a id="l00707" name="l00707"></a><span class="lineno">  707</span><span class="comment">   * frequently.  Just be aware it will block the calling thread, albeit still only for a split second in normal</span></div>
<div class="line"><a id="l00708" name="l00708"></a><span class="lineno">  708</span><span class="comment">   * conditions.</span></div>
<div class="line"><a id="l00709" name="l00709"></a><span class="lineno">  709</span><span class="comment">   *</span></div>
<div class="line"><a id="l00710" name="l00710"></a><span class="lineno">  710</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l00711" name="l00711"></a><span class="lineno">  711</span><span class="comment">   *         These must be `S_d_value_set` template param pack args 1, 3, ..., numbering</span></div>
<div class="line"><a id="l00712" name="l00712"></a><span class="lineno">  712</span><span class="comment">   *         #S_N_D_VALUE_SETS in order.</span></div>
<div class="line"><a id="l00713" name="l00713"></a><span class="lineno">  713</span><span class="comment">   * @param dynamic_cfg_path</span></div>
<div class="line"><a id="l00714" name="l00714"></a><span class="lineno">  714</span><span class="comment">   *        File to read.</span></div>
<div class="line"><a id="l00715" name="l00715"></a><span class="lineno">  715</span><span class="comment">   * @param final_validator_func</span></div>
<div class="line"><a id="l00716" name="l00716"></a><span class="lineno">  716</span><span class="comment">   *        See apply_static_and_dynamic().</span></div>
<div class="line"><a id="l00717" name="l00717"></a><span class="lineno">  717</span><span class="comment">   * @param commit</span></div>
<div class="line"><a id="l00718" name="l00718"></a><span class="lineno">  718</span><span class="comment">   *        `true` means that this call being successful (returning `true`) shall cause the promotion of</span></div>
<div class="line"><a id="l00719" name="l00719"></a><span class="lineno">  719</span><span class="comment">   *        each candidate `Value_set` built-up so far (via this and all preceding successful calls with</span></div>
<div class="line"><a id="l00720" name="l00720"></a><span class="lineno">  720</span><span class="comment">   *        `commit == false`) to canonical state (accessed via dynamic_values() or all_dynamic_values());</span></div>
<div class="line"><a id="l00721" name="l00721"></a><span class="lineno">  721</span><span class="comment">   *        and all relevant dynamic change listeners are synchronously called for each `Value_set` for which</span></div>
<div class="line"><a id="l00722" name="l00722"></a><span class="lineno">  722</span><span class="comment">   *        the cumulative candidate differs from the canonical state.</span></div>
<div class="line"><a id="l00723" name="l00723"></a><span class="lineno">  723</span><span class="comment">   *        `false` means that this call being successful shall merely create-and-set (if first such call)</span></div>
<div class="line"><a id="l00724" name="l00724"></a><span class="lineno">  724</span><span class="comment">   *        or incrementally update (if 2nd, 3rd, ... such call) each candidate `Value_set`; no dynamic change</span></div>
<div class="line"><a id="l00725" name="l00725"></a><span class="lineno">  725</span><span class="comment">   *        listeners are invoked.</span></div>
<div class="line"><a id="l00726" name="l00726"></a><span class="lineno">  726</span><span class="comment">   * @return `true` if and only if successfully parsed config source(s) and validated all settings including</span></div>
<div class="line"><a id="l00727" name="l00727"></a><span class="lineno">  727</span><span class="comment">   *         `final_validator_func() != S_FAIL` for *all* (dynamic) config sets; and defaults were also all</span></div>
<div class="line"><a id="l00728" name="l00728"></a><span class="lineno">  728</span><span class="comment">   *         individually valid, in the case of initial apply_dynamic().  However, if `true` but `commit == false`,</span></div>
<div class="line"><a id="l00729" name="l00729"></a><span class="lineno">  729</span><span class="comment">   *         then the canonical values (accessed via dynamic_values() or all_dynamic_values()) have not been updated.</span></div>
<div class="line"><a id="l00730" name="l00730"></a><span class="lineno">  730</span><span class="comment">   */</span></div>
<div class="line"><a id="l00731" name="l00731"></a><span class="lineno">  731</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l00732" name="l00732"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a26712af2d38d3afbeb52d21b7012a03c">  732</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a26712af2d38d3afbeb52d21b7012a03c">apply_dynamic</a>(<span class="keyword">const</span> fs::path&amp; dynamic_cfg_path,</div>
<div class="line"><a id="l00733" name="l00733"></a><span class="lineno">  733</span>                     <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;Value_set&gt;::Type</a>&amp;... final_validator_func,</div>
<div class="line"><a id="l00734" name="l00734"></a><span class="lineno">  734</span>                     <span class="keywordtype">bool</span> commit = <span class="keyword">true</span>);</div>
<div class="line"><a id="l00735" name="l00735"></a><span class="lineno">  735</span><span class="comment"></span> </div>
<div class="line"><a id="l00736" name="l00736"></a><span class="lineno">  736</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00737" name="l00737"></a><span class="lineno">  737</span><span class="comment">   * Identical to apply_dynamic() overload without #allow_invalid_defaults_tag_t tag; except that -- applicably only to</span></div>
<div class="line"><a id="l00738" name="l00738"></a><span class="lineno">  738</span><span class="comment">   * the initial apply_dynamic() without a preceding apply_static_and_dynamic() -- skips the stringent</span></div>
<div class="line"><a id="l00739" name="l00739"></a><span class="lineno">  739</span><span class="comment">   * check on individual defaults&#39; validity.</span></div>
<div class="line"><a id="l00740" name="l00740"></a><span class="lineno">  740</span><span class="comment">   *</span></div>
<div class="line"><a id="l00741" name="l00741"></a><span class="lineno">  741</span><span class="comment">   * @see #allow_invalid_defaults_tag_t doc header and/or return-value doc just below.</span></div>
<div class="line"><a id="l00742" name="l00742"></a><span class="lineno">  742</span><span class="comment">   *</span></div>
<div class="line"><a id="l00743" name="l00743"></a><span class="lineno">  743</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l00744" name="l00744"></a><span class="lineno">  744</span><span class="comment">   *         See other apply_dynamic().</span></div>
<div class="line"><a id="l00745" name="l00745"></a><span class="lineno">  745</span><span class="comment">   * @param dynamic_cfg_path</span></div>
<div class="line"><a id="l00746" name="l00746"></a><span class="lineno">  746</span><span class="comment">   *        See other apply_dynamic().</span></div>
<div class="line"><a id="l00747" name="l00747"></a><span class="lineno">  747</span><span class="comment">   * @param final_validator_func</span></div>
<div class="line"><a id="l00748" name="l00748"></a><span class="lineno">  748</span><span class="comment">   *        See other apply_dynamic().</span></div>
<div class="line"><a id="l00749" name="l00749"></a><span class="lineno">  749</span><span class="comment">   * @param commit</span></div>
<div class="line"><a id="l00750" name="l00750"></a><span class="lineno">  750</span><span class="comment">   *        See other apply_dynamic().</span></div>
<div class="line"><a id="l00751" name="l00751"></a><span class="lineno">  751</span><span class="comment">   * @return See other apply_dynamic().  However -- assuming apply_static_and_dynamic() was not used, and</span></div>
<div class="line"><a id="l00752" name="l00752"></a><span class="lineno">  752</span><span class="comment">   *         this is the initial apply_dynamic() -- the other apply_dynamic() will return `false` if a default is</span></div>
<div class="line"><a id="l00753" name="l00753"></a><span class="lineno">  753</span><span class="comment">   *         invalid, even if file `dynamic_cfg_path` explicitly sets it to a valid value.  This tagged overload will</span></div>
<div class="line"><a id="l00754" name="l00754"></a><span class="lineno">  754</span><span class="comment">   *         not and let parsing continue.  If `apply_static_and_dynamic(commit = true) == true` was used, or</span></div>
<div class="line"><a id="l00755" name="l00755"></a><span class="lineno">  755</span><span class="comment">   *         if `apply_dynamic(commit = true) == true` has been called before, then the overloads behave</span></div>
<div class="line"><a id="l00756" name="l00756"></a><span class="lineno">  756</span><span class="comment">   *         identically: defaults are not checked; it must occur just before the initial dynamic load or never.</span></div>
<div class="line"><a id="l00757" name="l00757"></a><span class="lineno">  757</span><span class="comment">   */</span></div>
<div class="line"><a id="l00758" name="l00758"></a><span class="lineno">  758</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l00759" name="l00759"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a2503b020137aca00a8ee4b81fc921750">  759</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a2503b020137aca00a8ee4b81fc921750">apply_dynamic</a>(<a class="code hl_enumeration" href="classflow_1_1cfg_1_1Config__manager.html#a6768eb0c92bd11fd84986058903b10d4">allow_invalid_defaults_tag_t</a>,</div>
<div class="line"><a id="l00760" name="l00760"></a><span class="lineno">  760</span>                     <span class="keyword">const</span> fs::path&amp; dynamic_cfg_path,</div>
<div class="line"><a id="l00761" name="l00761"></a><span class="lineno">  761</span>                     <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;Value_set&gt;::Type</a>&amp;... final_validator_func,</div>
<div class="line"><a id="l00762" name="l00762"></a><span class="lineno">  762</span>                     <span class="keywordtype">bool</span> commit = <span class="keyword">true</span>);</div>
<div class="line"><a id="l00763" name="l00763"></a><span class="lineno">  763</span><span class="comment"></span> </div>
<div class="line"><a id="l00764" name="l00764"></a><span class="lineno">  764</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00765" name="l00765"></a><span class="lineno">  765</span><span class="comment">   * Cancel a not-yet-canonicalized (incomplete) multi-source update, if one is in progress.  If one is not</span></div>
<div class="line"><a id="l00766" name="l00766"></a><span class="lineno">  766</span><span class="comment">   * in-progress, INFO-log but otherwise no-op.</span></div>
<div class="line"><a id="l00767" name="l00767"></a><span class="lineno">  767</span><span class="comment">   *</span></div>
<div class="line"><a id="l00768" name="l00768"></a><span class="lineno">  768</span><span class="comment">   * This method only has effect following apply_static(), apply_static_and_dynamic(), or apply_dynamic() that</span></div>
<div class="line"><a id="l00769" name="l00769"></a><span class="lineno">  769</span><span class="comment">   *   - returned `true`; and</span></div>
<div class="line"><a id="l00770" name="l00770"></a><span class="lineno">  770</span><span class="comment">   *   - had arg `commit == false`.</span></div>
<div class="line"><a id="l00771" name="l00771"></a><span class="lineno">  771</span><span class="comment">   *</span></div>
<div class="line"><a id="l00772" name="l00772"></a><span class="lineno">  772</span><span class="comment">   * That is, if there are pending *candidate* `Value_set`s that have not yet been upgraded to canonical status</span></div>
<div class="line"><a id="l00773" name="l00773"></a><span class="lineno">  773</span><span class="comment">   * via a `commit == true` `apply_*()` call, this call discards them, making it as-if no such call(s) were</span></div>
<div class="line"><a id="l00774" name="l00774"></a><span class="lineno">  774</span><span class="comment">   * made in the first place.</span></div>
<div class="line"><a id="l00775" name="l00775"></a><span class="lineno">  775</span><span class="comment">   *</span></div>
<div class="line"><a id="l00776" name="l00776"></a><span class="lineno">  776</span><span class="comment">   * Informally we do not expect this to be commonly used; typically `apply_*()` will automatically do this</span></div>
<div class="line"><a id="l00777" name="l00777"></a><span class="lineno">  777</span><span class="comment">   * upon encountering an error (in individual option validation or due to Final_validator_outcome::S_FAIL).</span></div>
<div class="line"><a id="l00778" name="l00778"></a><span class="lineno">  778</span><span class="comment">   * However if there is some outside reason to abort an ongoing, so-far-successful multi-source update</span></div>
<div class="line"><a id="l00779" name="l00779"></a><span class="lineno">  779</span><span class="comment">   * this method will similarly do it.</span></div>
<div class="line"><a id="l00780" name="l00780"></a><span class="lineno">  780</span><span class="comment">   */</span></div>
<div class="line"><a id="l00781" name="l00781"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#ac1ab5cefe86e6aaa0518d675f309907e">  781</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#ac1ab5cefe86e6aaa0518d675f309907e">reject_candidates</a>();</div>
<div class="line"><a id="l00782" name="l00782"></a><span class="lineno">  782</span><span class="comment"></span> </div>
<div class="line"><a id="l00783" name="l00783"></a><span class="lineno">  783</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00784" name="l00784"></a><span class="lineno">  784</span><span class="comment">   * Emit a pointer to each permanently set static config value set; the same pointers are emitted throughout</span></div>
<div class="line"><a id="l00785" name="l00785"></a><span class="lineno">  785</span><span class="comment">   * for each of the #S_N_S_VALUE_SETS static config slots.  Tip: It should be sufficient to pass around only `const`</span></div>
<div class="line"><a id="l00786" name="l00786"></a><span class="lineno">  786</span><span class="comment">   * refs (from the pointers obtained here) all around the app -- no `Value_set` copying should be needed.</span></div>
<div class="line"><a id="l00787" name="l00787"></a><span class="lineno">  787</span><span class="comment">   *</span></div>
<div class="line"><a id="l00788" name="l00788"></a><span class="lineno">  788</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l00789" name="l00789"></a><span class="lineno">  789</span><span class="comment">   *         These must be `S_d_value_set` template param pack args 0, 2, ..., numbering</span></div>
<div class="line"><a id="l00790" name="l00790"></a><span class="lineno">  790</span><span class="comment">   *         #S_N_S_VALUE_SETS in order.  The compiler should be able to deduce them automatically from</span></div>
<div class="line"><a id="l00791" name="l00791"></a><span class="lineno">  791</span><span class="comment">   *         each `value_set_or_null` type; though when passing in null it may be then necessary to cast `nullptr`</span></div>
<div class="line"><a id="l00792" name="l00792"></a><span class="lineno">  792</span><span class="comment">   *         (or `0`) to the appropriate pointer type.</span></div>
<div class="line"><a id="l00793" name="l00793"></a><span class="lineno">  793</span><span class="comment">   * @param value_set_or_null</span></div>
<div class="line"><a id="l00794" name="l00794"></a><span class="lineno">  794</span><span class="comment">   *        For each element in the param pack:</span></div>
<div class="line"><a id="l00795" name="l00795"></a><span class="lineno">  795</span><span class="comment">   *        `*value_set_or_null` is set to point to the immutable static config set in that slot;</span></div>
<div class="line"><a id="l00796" name="l00796"></a><span class="lineno">  796</span><span class="comment">   *        or that slot is ignored if `value_set_or_null` is null.</span></div>
<div class="line"><a id="l00797" name="l00797"></a><span class="lineno">  797</span><span class="comment">   */</span></div>
<div class="line"><a id="l00798" name="l00798"></a><span class="lineno">  798</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l00799" name="l00799"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a76c7224711ef8a51c7005629e4eae6e7">  799</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a76c7224711ef8a51c7005629e4eae6e7">all_static_values</a>(<span class="keyword">const</span> Value_set**... value_set_or_null) <span class="keyword">const</span>;</div>
<div class="line"><a id="l00800" name="l00800"></a><span class="lineno">  800</span><span class="comment"></span> </div>
<div class="line"><a id="l00801" name="l00801"></a><span class="lineno">  801</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00802" name="l00802"></a><span class="lineno">  802</span><span class="comment">   * Similar to all_static_values(), but if called from within a validator function passed to apply_static() or</span></div>
<div class="line"><a id="l00803" name="l00803"></a><span class="lineno">  803</span><span class="comment">   * apply_static_and_dynamic(), then for any static value set for which values have been parsed and validated (but not</span></div>
<div class="line"><a id="l00804" name="l00804"></a><span class="lineno">  804</span><span class="comment">   * yet applied) so far, a pointer to the parsed values *candidate* will be emitted instead.  If called from elsewhere,</span></div>
<div class="line"><a id="l00805" name="l00805"></a><span class="lineno">  805</span><span class="comment">   * the behavior is equivalent to all_static_values().  A values candidate consists of what has been parsed and</span></div>
<div class="line"><a id="l00806" name="l00806"></a><span class="lineno">  806</span><span class="comment">   * validated (and not skipped via Final_validator_outcome::S_SKIP) for the value set, but has not yet been applied</span></div>
<div class="line"><a id="l00807" name="l00807"></a><span class="lineno">  807</span><span class="comment">   * such that it would be available through all_static_values().</span></div>
<div class="line"><a id="l00808" name="l00808"></a><span class="lineno">  808</span><span class="comment">   *</span></div>
<div class="line"><a id="l00809" name="l00809"></a><span class="lineno">  809</span><span class="comment">   * This could be useful to provide static values to a final validator function for another value set which depends on</span></div>
<div class="line"><a id="l00810" name="l00810"></a><span class="lineno">  810</span><span class="comment">   * them.  During the execution of apply_static() or apply_static_and_dynamic(), the validator function for each value</span></div>
<div class="line"><a id="l00811" name="l00811"></a><span class="lineno">  811</span><span class="comment">   * set will be executed before any are canonicalized.  This method can be used by a validator function to obtain the</span></div>
<div class="line"><a id="l00812" name="l00812"></a><span class="lineno">  812</span><span class="comment">   * candidate values which have been parsed and validated (but have not yet been canonicalized) for a preceding static</span></div>
<div class="line"><a id="l00813" name="l00813"></a><span class="lineno">  813</span><span class="comment">   * value set.</span></div>
<div class="line"><a id="l00814" name="l00814"></a><span class="lineno">  814</span><span class="comment">   *</span></div>
<div class="line"><a id="l00815" name="l00815"></a><span class="lineno">  815</span><span class="comment">   * @see all_static_values().</span></div>
<div class="line"><a id="l00816" name="l00816"></a><span class="lineno">  816</span><span class="comment">   *</span></div>
<div class="line"><a id="l00817" name="l00817"></a><span class="lineno">  817</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l00818" name="l00818"></a><span class="lineno">  818</span><span class="comment">   *         See all_static_values().</span></div>
<div class="line"><a id="l00819" name="l00819"></a><span class="lineno">  819</span><span class="comment">   * @param value_set_or_null</span></div>
<div class="line"><a id="l00820" name="l00820"></a><span class="lineno">  820</span><span class="comment">   *        See all_static_values().</span></div>
<div class="line"><a id="l00821" name="l00821"></a><span class="lineno">  821</span><span class="comment">   */</span></div>
<div class="line"><a id="l00822" name="l00822"></a><span class="lineno">  822</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l00823" name="l00823"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a616c39cdf1c6f7f4d2af3a3055edf486">  823</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a616c39cdf1c6f7f4d2af3a3055edf486">all_static_values_candidates</a>(<span class="keyword">const</span> Value_set**... value_set_or_null) <span class="keyword">const</span>;</div>
<div class="line"><a id="l00824" name="l00824"></a><span class="lineno">  824</span><span class="comment"></span> </div>
<div class="line"><a id="l00825" name="l00825"></a><span class="lineno">  825</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00826" name="l00826"></a><span class="lineno">  826</span><span class="comment">   * Similar to all_static_values(), but obtains the static config in *one* specified slot as opposed to all of them.</span></div>
<div class="line"><a id="l00827" name="l00827"></a><span class="lineno">  827</span><span class="comment">   *</span></div>
<div class="line"><a id="l00828" name="l00828"></a><span class="lineno">  828</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l00829" name="l00829"></a><span class="lineno">  829</span><span class="comment">   *         This must be `S_d_value_set` template param pack args in position `2 * s_value_set_idx`</span></div>
<div class="line"><a id="l00830" name="l00830"></a><span class="lineno">  830</span><span class="comment">   *         (so one of [0, 2, ..., `(2 * S_N_S_VALUE_SETS) - 2`]).</span></div>
<div class="line"><a id="l00831" name="l00831"></a><span class="lineno">  831</span><span class="comment">   *         You will need to explicitly specify this `tparam`.  E.g.:</span></div>
<div class="line"><a id="l00832" name="l00832"></a><span class="lineno">  832</span><span class="comment">   *         `const auto cfg_ptr = cfg_mgr.static_values&lt;S_cfg2&gt;(1)`.</span></div>
<div class="line"><a id="l00833" name="l00833"></a><span class="lineno">  833</span><span class="comment">   * @param s_value_set_idx</span></div>
<div class="line"><a id="l00834" name="l00834"></a><span class="lineno">  834</span><span class="comment">   *        The static config slot index; so one of [0, 1, ..., #S_N_S_VALUE_SETS).</span></div>
<div class="line"><a id="l00835" name="l00835"></a><span class="lineno">  835</span><span class="comment">   * @return The immutable, permanently set static config value set in the `s_value_set_idx` slot.</span></div>
<div class="line"><a id="l00836" name="l00836"></a><span class="lineno">  836</span><span class="comment">   */</span></div>
<div class="line"><a id="l00837" name="l00837"></a><span class="lineno">  837</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l00838" name="l00838"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a8431806f82bed676f5fedb3b64f67245">  838</a></span>  <span class="keyword">const</span> Value_set&amp; <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a8431806f82bed676f5fedb3b64f67245">static_values</a>(<span class="keywordtype">size_t</span> s_value_set_idx) <span class="keyword">const</span>;</div>
<div class="line"><a id="l00839" name="l00839"></a><span class="lineno">  839</span><span class="comment"></span> </div>
<div class="line"><a id="l00840" name="l00840"></a><span class="lineno">  840</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00841" name="l00841"></a><span class="lineno">  841</span><span class="comment">   * Similar to static_values(), but if called from within a validator function passed to apply_static() or</span></div>
<div class="line"><a id="l00842" name="l00842"></a><span class="lineno">  842</span><span class="comment">   * apply_static_and_dynamic(), then the parsed values *candidate* will be returned, instead, if values have been</span></div>
<div class="line"><a id="l00843" name="l00843"></a><span class="lineno">  843</span><span class="comment">   * parsed and validated for the static value set but have not yet been applied.  Otherwise, the behavior is equivalent</span></div>
<div class="line"><a id="l00844" name="l00844"></a><span class="lineno">  844</span><span class="comment">   * to static_values().</span></div>
<div class="line"><a id="l00845" name="l00845"></a><span class="lineno">  845</span><span class="comment">   *</span></div>
<div class="line"><a id="l00846" name="l00846"></a><span class="lineno">  846</span><span class="comment">   * @see all_static_values_candidates().</span></div>
<div class="line"><a id="l00847" name="l00847"></a><span class="lineno">  847</span><span class="comment">   *</span></div>
<div class="line"><a id="l00848" name="l00848"></a><span class="lineno">  848</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l00849" name="l00849"></a><span class="lineno">  849</span><span class="comment">   *         See static_values().</span></div>
<div class="line"><a id="l00850" name="l00850"></a><span class="lineno">  850</span><span class="comment">   * @param s_value_set_idx</span></div>
<div class="line"><a id="l00851" name="l00851"></a><span class="lineno">  851</span><span class="comment">   *        See static_values().</span></div>
<div class="line"><a id="l00852" name="l00852"></a><span class="lineno">  852</span><span class="comment">   * @return See above and static_values().</span></div>
<div class="line"><a id="l00853" name="l00853"></a><span class="lineno">  853</span><span class="comment">   */</span></div>
<div class="line"><a id="l00854" name="l00854"></a><span class="lineno">  854</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l00855" name="l00855"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#ae034a71792f952256c18e385475627d1">  855</a></span>  <span class="keyword">const</span> Value_set&amp; <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#ae034a71792f952256c18e385475627d1">static_values_candidate</a>(<span class="keywordtype">size_t</span> s_value_set_idx) <span class="keyword">const</span>;</div>
<div class="line"><a id="l00856" name="l00856"></a><span class="lineno">  856</span><span class="comment"></span> </div>
<div class="line"><a id="l00857" name="l00857"></a><span class="lineno">  857</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00858" name="l00858"></a><span class="lineno">  858</span><span class="comment">   * Obtain ref-counted pointers to each currently-canonical set of dynamic config; each pointed-at `struct` is set</span></div>
<div class="line"><a id="l00859" name="l00859"></a><span class="lineno">  859</span><span class="comment">   * permanently; while another call may return a different pointer if config is changed dynamically in the meantime</span></div>
<div class="line"><a id="l00860" name="l00860"></a><span class="lineno">  860</span><span class="comment">   * (for that slot).  For each slot: If you require a consistent set of dynamic config over some period of time or over</span></div>
<div class="line"><a id="l00861" name="l00861"></a><span class="lineno">  861</span><span class="comment">   * some code path, save a copy of the returned ref-counted pointer to the `Value_set` and keep accessing values in</span></div>
<div class="line"><a id="l00862" name="l00862"></a><span class="lineno">  862</span><span class="comment">   * that immutable structure through that ref-counted pointer.</span></div>
<div class="line"><a id="l00863" name="l00863"></a><span class="lineno">  863</span><span class="comment">   *</span></div>
<div class="line"><a id="l00864" name="l00864"></a><span class="lineno">  864</span><span class="comment">   * After the initial apply_dynamic(): It is safe to call all_dynamic_values() concurrently with any number of itself</span></div>
<div class="line"><a id="l00865" name="l00865"></a><span class="lineno">  865</span><span class="comment">   * or of dynamic_values() and/or a call to `apply_dynamic(commit = *)`.</span></div>
<div class="line"><a id="l00866" name="l00866"></a><span class="lineno">  866</span><span class="comment">   *</span></div>
<div class="line"><a id="l00867" name="l00867"></a><span class="lineno">  867</span><span class="comment">   * @note Have each `Value_set` derive from util::Shared_ptr_alias_holder, so that it is endowed with</span></div>
<div class="line"><a id="l00868" name="l00868"></a><span class="lineno">  868</span><span class="comment">   *       `Ptr` and `Const_ptr` ref-counted pointer type aliases, for your convenience and as required by</span></div>
<div class="line"><a id="l00869" name="l00869"></a><span class="lineno">  869</span><span class="comment">   *       Config_manager and Option_set.</span></div>
<div class="line"><a id="l00870" name="l00870"></a><span class="lineno">  870</span><span class="comment">   *</span></div>
<div class="line"><a id="l00871" name="l00871"></a><span class="lineno">  871</span><span class="comment">   * ### Performance ###</span></div>
<div class="line"><a id="l00872" name="l00872"></a><span class="lineno">  872</span><span class="comment">   * dynamic_values() performance is no worse than: lock mutex,</span></div>
<div class="line"><a id="l00873" name="l00873"></a><span class="lineno">  873</span><span class="comment">   * copy #S_N_D_VALUE_SETS `shared_ptr`s, unlock mutex.  See also Performance section of</span></div>
<div class="line"><a id="l00874" name="l00874"></a><span class="lineno">  874</span><span class="comment">   * apply_dynamic() doc header.</span></div>
<div class="line"><a id="l00875" name="l00875"></a><span class="lineno">  875</span><span class="comment">   *</span></div>
<div class="line"><a id="l00876" name="l00876"></a><span class="lineno">  876</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l00877" name="l00877"></a><span class="lineno">  877</span><span class="comment">   *         These must be `S_d_value_set` template param pack args 1, 3, ..., numbering</span></div>
<div class="line"><a id="l00878" name="l00878"></a><span class="lineno">  878</span><span class="comment">   *         #S_N_D_VALUE_SETS in order.  Likely you will need to explicitly specify them, as the compiler will</span></div>
<div class="line"><a id="l00879" name="l00879"></a><span class="lineno">  879</span><span class="comment">   *         probably not deduce them.  E.g.:</span></div>
<div class="line"><a id="l00880" name="l00880"></a><span class="lineno">  880</span><span class="comment">   *         `cfg_mgr.all_dynamic_values&lt;D_cfg1, D_cfg2, Null_value_set&gt;(&amp;d1, &amp;d2, 0)`.</span></div>
<div class="line"><a id="l00881" name="l00881"></a><span class="lineno">  881</span><span class="comment">   * @param value_set_or_null</span></div>
<div class="line"><a id="l00882" name="l00882"></a><span class="lineno">  882</span><span class="comment">   *        For each element in the param pack:</span></div>
<div class="line"><a id="l00883" name="l00883"></a><span class="lineno">  883</span><span class="comment">   *        `*value_set_or_null` is set to point to the immutable dynamic config set currently canonical in that slot;</span></div>
<div class="line"><a id="l00884" name="l00884"></a><span class="lineno">  884</span><span class="comment">   *        or that slot is ignored if `value_set_or_null` is null.</span></div>
<div class="line"><a id="l00885" name="l00885"></a><span class="lineno">  885</span><span class="comment">   *        Remember: `**value_set_or_null` is immutable; but another call may yield a different</span></div>
<div class="line"><a id="l00886" name="l00886"></a><span class="lineno">  886</span><span class="comment">   *        `*value_set_or_null`.</span></div>
<div class="line"><a id="l00887" name="l00887"></a><span class="lineno">  887</span><span class="comment">   */</span></div>
<div class="line"><a id="l00888" name="l00888"></a><span class="lineno">  888</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l00889" name="l00889"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a6afb8620600dcb54d41211ef68859f93">  889</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a6afb8620600dcb54d41211ef68859f93">all_dynamic_values</a>(<span class="keyword">typename</span> Value_set::Const_ptr*... value_set_or_null) <span class="keyword">const</span>;</div>
<div class="line"><a id="l00890" name="l00890"></a><span class="lineno">  890</span><span class="comment"></span> </div>
<div class="line"><a id="l00891" name="l00891"></a><span class="lineno">  891</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00892" name="l00892"></a><span class="lineno">  892</span><span class="comment">   * Similar to all_dynamic_values() but obtains the dynamic config in *one* specified slot as opposed to all of them.</span></div>
<div class="line"><a id="l00893" name="l00893"></a><span class="lineno">  893</span><span class="comment">   *</span></div>
<div class="line"><a id="l00894" name="l00894"></a><span class="lineno">  894</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l00895" name="l00895"></a><span class="lineno">  895</span><span class="comment">   *         This must be `S_d_value_set` template param pack args in position `1 + 2 * d_value_set_idx`</span></div>
<div class="line"><a id="l00896" name="l00896"></a><span class="lineno">  896</span><span class="comment">   *         (so one of [1, 3, ..., `(2 * S_N_D_VALUE_SETS) - 1`]).</span></div>
<div class="line"><a id="l00897" name="l00897"></a><span class="lineno">  897</span><span class="comment">   *         You will need to explicitly specify this `tparam`.  E.g.:</span></div>
<div class="line"><a id="l00898" name="l00898"></a><span class="lineno">  898</span><span class="comment">   *         `const auto cfg_ptr = cfg_mgr.dynamic_values&lt;D_cfg2&gt;(1)`.</span></div>
<div class="line"><a id="l00899" name="l00899"></a><span class="lineno">  899</span><span class="comment">   * @param d_value_set_idx</span></div>
<div class="line"><a id="l00900" name="l00900"></a><span class="lineno">  900</span><span class="comment">   *        The dynamic config slot index; so one of [0, 1, ..., #S_N_D_VALUE_SETS).</span></div>
<div class="line"><a id="l00901" name="l00901"></a><span class="lineno">  901</span><span class="comment">   * @return Ref-counted pointer to the immutable dynamic config set currently canonical in that slot.</span></div>
<div class="line"><a id="l00902" name="l00902"></a><span class="lineno">  902</span><span class="comment">   *         Remember: if `p` returned, then `*p` is immutable; but another dynamic_values() call may return</span></div>
<div class="line"><a id="l00903" name="l00903"></a><span class="lineno">  903</span><span class="comment">   *         a different `p2` not equal to `p`.</span></div>
<div class="line"><a id="l00904" name="l00904"></a><span class="lineno">  904</span><span class="comment">   */</span></div>
<div class="line"><a id="l00905" name="l00905"></a><span class="lineno">  905</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l00906" name="l00906"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#ac2239443cf48bfdaa78c95af935e1d0f">  906</a></span>  <span class="keyword">typename</span> Value_set::Const_ptr <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#ac2239443cf48bfdaa78c95af935e1d0f">dynamic_values</a>(<span class="keywordtype">size_t</span> d_value_set_idx) <span class="keyword">const</span>;</div>
<div class="line"><a id="l00907" name="l00907"></a><span class="lineno">  907</span><span class="comment"></span> </div>
<div class="line"><a id="l00908" name="l00908"></a><span class="lineno">  908</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00909" name="l00909"></a><span class="lineno">  909</span><span class="comment">   * Saves the given callback; next time `apply_dynamic(commit = true)` or</span></div>
<div class="line"><a id="l00910" name="l00910"></a><span class="lineno">  910</span><span class="comment">   * `apply_static_and_dynamic(commit = true)` detects at least one changed (or initially set) option value</span></div>
<div class="line"><a id="l00911" name="l00911"></a><span class="lineno">  911</span><span class="comment">   * in the specified slot, it will execute this and any other previously registered such callbacks</span></div>
<div class="line"><a id="l00912" name="l00912"></a><span class="lineno">  912</span><span class="comment">   * synchronously.  The callbacks will be called after the pointers to be returned by all_dynamic_values() have all</span></div>
<div class="line"><a id="l00913" name="l00913"></a><span class="lineno">  913</span><span class="comment">   * been updated.</span></div>
<div class="line"><a id="l00914" name="l00914"></a><span class="lineno">  914</span><span class="comment">   *</span></div>
<div class="line"><a id="l00915" name="l00915"></a><span class="lineno">  915</span><span class="comment">   * This is not thread-safe against concurrent calls to itself; nor against concurrent</span></div>
<div class="line"><a id="l00916" name="l00916"></a><span class="lineno">  916</span><span class="comment">   * `apply_dynamic(commit = true)` (against `apply_dynamic(commit = false)` is okay),</span></div>
<div class="line"><a id="l00917" name="l00917"></a><span class="lineno">  917</span><span class="comment">   * `apply_static_and_dynamic(commit = true)` (against `apply_static_and_dynamic(commit = false)` is okay), or</span></div>
<div class="line"><a id="l00918" name="l00918"></a><span class="lineno">  918</span><span class="comment">   * unregister_dynamic_change_listener().</span></div>
<div class="line"><a id="l00919" name="l00919"></a><span class="lineno">  919</span><span class="comment">   *</span></div>
<div class="line"><a id="l00920" name="l00920"></a><span class="lineno">  920</span><span class="comment">   * @note The callback may optionally be unregistered by using unregister_dynamic_change_listener().  This *should* be</span></div>
<div class="line"><a id="l00921" name="l00921"></a><span class="lineno">  921</span><span class="comment">   *       done before anything that the callback accesses is invalidated.  If there is a chance that `apply*_dynamic()`</span></div>
<div class="line"><a id="l00922" name="l00922"></a><span class="lineno">  922</span><span class="comment">   *       might be called later, then the callback *must* be unregistered before anything that it accesses is</span></div>
<div class="line"><a id="l00923" name="l00923"></a><span class="lineno">  923</span><span class="comment">   *       invalidated, otherwise there could be undefined behavior when the callback accesses something which is</span></div>
<div class="line"><a id="l00924" name="l00924"></a><span class="lineno">  924</span><span class="comment">   *       invalid.</span></div>
<div class="line"><a id="l00925" name="l00925"></a><span class="lineno">  925</span><span class="comment">   *</span></div>
<div class="line"><a id="l00926" name="l00926"></a><span class="lineno">  926</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l00927" name="l00927"></a><span class="lineno">  927</span><span class="comment">   *         See dynamic_values().</span></div>
<div class="line"><a id="l00928" name="l00928"></a><span class="lineno">  928</span><span class="comment">   * @param d_value_set_idx</span></div>
<div class="line"><a id="l00929" name="l00929"></a><span class="lineno">  929</span><span class="comment">   *        See dynamic_values().</span></div>
<div class="line"><a id="l00930" name="l00930"></a><span class="lineno">  930</span><span class="comment">   * @param on_dynamic_change_func_moved</span></div>
<div class="line"><a id="l00931" name="l00931"></a><span class="lineno">  931</span><span class="comment">   *        Function to call synchronously from the next `apply*_dynamic()` that detects a change.</span></div>
<div class="line"><a id="l00932" name="l00932"></a><span class="lineno">  932</span><span class="comment">   * @return A handle which can be used to unregister the callback.</span></div>
<div class="line"><a id="l00933" name="l00933"></a><span class="lineno">  933</span><span class="comment">   */</span></div>
<div class="line"><a id="l00934" name="l00934"></a><span class="lineno">  934</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l00935" name="l00935"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a978295c03998af212b464061d780520b">  935</a></span>  On_dynamic_change_func_handle <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a978295c03998af212b464061d780520b">register_dynamic_change_listener</a>(<span class="keywordtype">size_t</span> d_value_set_idx,</div>
<div class="line"><a id="l00936" name="l00936"></a><span class="lineno">  936</span>                                                                 <a class="code hl_class" href="classflow_1_1Function.html">On_dynamic_change_func</a>&amp;&amp; on_dynamic_change_func_moved);</div>
<div class="line"><a id="l00937" name="l00937"></a><span class="lineno">  937</span><span class="comment"></span> </div>
<div class="line"><a id="l00938" name="l00938"></a><span class="lineno">  938</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00939" name="l00939"></a><span class="lineno">  939</span><span class="comment">   * Remove a previously registered dynamic change callback.  See register_dynamic_change_listener().</span></div>
<div class="line"><a id="l00940" name="l00940"></a><span class="lineno">  940</span><span class="comment">   *</span></div>
<div class="line"><a id="l00941" name="l00941"></a><span class="lineno">  941</span><span class="comment">   * This is not thread-safe against concurrent calls to itself; nor against concurrent</span></div>
<div class="line"><a id="l00942" name="l00942"></a><span class="lineno">  942</span><span class="comment">   * `apply_dynamic(commit = true)` (against `apply_dynamic(commit = false)` is okay),</span></div>
<div class="line"><a id="l00943" name="l00943"></a><span class="lineno">  943</span><span class="comment">   * `apply_static_and_dynamic(commit = true)` (against `apply_static_and_dynamic(commit = false)` is okay), or</span></div>
<div class="line"><a id="l00944" name="l00944"></a><span class="lineno">  944</span><span class="comment">   * register_dynamic_change_listener().</span></div>
<div class="line"><a id="l00945" name="l00945"></a><span class="lineno">  945</span><span class="comment">   *</span></div>
<div class="line"><a id="l00946" name="l00946"></a><span class="lineno">  946</span><span class="comment">   * @param handle</span></div>
<div class="line"><a id="l00947" name="l00947"></a><span class="lineno">  947</span><span class="comment">   *        The handle which was returned by register_dynamic_change_listener() when the callback was registered.</span></div>
<div class="line"><a id="l00948" name="l00948"></a><span class="lineno">  948</span><span class="comment">   */</span></div>
<div class="line"><a id="l00949" name="l00949"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a4e0dfe1e8f57d974a775f1320bd9856d">  949</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a4e0dfe1e8f57d974a775f1320bd9856d">unregister_dynamic_change_listener</a> (<span class="keyword">const</span> On_dynamic_change_func_handle&amp; handle);</div>
<div class="line"><a id="l00950" name="l00950"></a><span class="lineno">  950</span><span class="comment"></span> </div>
<div class="line"><a id="l00951" name="l00951"></a><span class="lineno">  951</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00952" name="l00952"></a><span class="lineno">  952</span><span class="comment">   * Prints a human-targeted long-form summary of our contents, doubling as a usage message and a dump of current</span></div>
<div class="line"><a id="l00953" name="l00953"></a><span class="lineno">  953</span><span class="comment">   * values where applicable.  This is not thread-safe against several non-`const` methods.</span></div>
<div class="line"><a id="l00954" name="l00954"></a><span class="lineno">  954</span><span class="comment">   *</span></div>
<div class="line"><a id="l00955" name="l00955"></a><span class="lineno">  955</span><span class="comment">   * @param os</span></div>
<div class="line"><a id="l00956" name="l00956"></a><span class="lineno">  956</span><span class="comment">   *        Stream to which to serialize.</span></div>
<div class="line"><a id="l00957" name="l00957"></a><span class="lineno">  957</span><span class="comment">   */</span></div>
<div class="line"><a id="l00958" name="l00958"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a19ae9775f51953805ea08086c276a78d">  958</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a19ae9775f51953805ea08086c276a78d">state_to_ostream</a>(std::ostream&amp; os) <span class="keyword">const</span>;</div>
<div class="line"><a id="l00959" name="l00959"></a><span class="lineno">  959</span><span class="comment"></span> </div>
<div class="line"><a id="l00960" name="l00960"></a><span class="lineno">  960</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00961" name="l00961"></a><span class="lineno">  961</span><span class="comment">   * Logs what state_to_ostream() would print.  This is not thread-safe against several non-`const` methods.</span></div>
<div class="line"><a id="l00962" name="l00962"></a><span class="lineno">  962</span><span class="comment">   *</span></div>
<div class="line"><a id="l00963" name="l00963"></a><span class="lineno">  963</span><span class="comment">   * @param sev</span></div>
<div class="line"><a id="l00964" name="l00964"></a><span class="lineno">  964</span><span class="comment">   *        Severity to use for the log message(s).</span></div>
<div class="line"><a id="l00965" name="l00965"></a><span class="lineno">  965</span><span class="comment">   */</span></div>
<div class="line"><a id="l00966" name="l00966"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a220535219634c62ed2a580934c76c481">  966</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a220535219634c62ed2a580934c76c481">log_state</a>(<a class="code hl_enumeration" href="namespaceflow_1_1log.html#a5c602384e6fe9d7642740ac2fae4ad04">log::Sev</a> sev = <a class="code hl_enumvalue" href="namespaceflow_1_1log.html#a5c602384e6fe9d7642740ac2fae4ad04ac238793326fae17afcc849e96b96e8e7">log::Sev::S_INFO</a>) <span class="keyword">const</span>;</div>
<div class="line"><a id="l00967" name="l00967"></a><span class="lineno">  967</span><span class="comment"></span> </div>
<div class="line"><a id="l00968" name="l00968"></a><span class="lineno">  968</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00969" name="l00969"></a><span class="lineno">  969</span><span class="comment">   * Prints a human-targeted long-form usage message that includes all options with their descriptions and defaults.</span></div>
<div class="line"><a id="l00970" name="l00970"></a><span class="lineno">  970</span><span class="comment">   * This is thread-safe against all concurrent methods on `*this` and can be invoked anytime after ctor.</span></div>
<div class="line"><a id="l00971" name="l00971"></a><span class="lineno">  971</span><span class="comment">   *</span></div>
<div class="line"><a id="l00972" name="l00972"></a><span class="lineno">  972</span><span class="comment">   * @param os</span></div>
<div class="line"><a id="l00973" name="l00973"></a><span class="lineno">  973</span><span class="comment">   *        Stream to which to serialize.</span></div>
<div class="line"><a id="l00974" name="l00974"></a><span class="lineno">  974</span><span class="comment">   */</span></div>
<div class="line"><a id="l00975" name="l00975"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#ad5cda6ace05e8bbe52a5129ed1c0720c">  975</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#ad5cda6ace05e8bbe52a5129ed1c0720c">help_to_ostream</a>(std::ostream&amp; os) <span class="keyword">const</span>;</div>
<div class="line"><a id="l00976" name="l00976"></a><span class="lineno">  976</span><span class="comment"></span> </div>
<div class="line"><a id="l00977" name="l00977"></a><span class="lineno">  977</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00978" name="l00978"></a><span class="lineno">  978</span><span class="comment">   * Logs what help_to_ostream() would print.</span></div>
<div class="line"><a id="l00979" name="l00979"></a><span class="lineno">  979</span><span class="comment">   *</span></div>
<div class="line"><a id="l00980" name="l00980"></a><span class="lineno">  980</span><span class="comment">   * @param sev</span></div>
<div class="line"><a id="l00981" name="l00981"></a><span class="lineno">  981</span><span class="comment">   *        Severity to use for the log message(s).</span></div>
<div class="line"><a id="l00982" name="l00982"></a><span class="lineno">  982</span><span class="comment">   */</span></div>
<div class="line"><a id="l00983" name="l00983"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a0192ddc2cc7302bdc8720ee56a395c02">  983</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a0192ddc2cc7302bdc8720ee56a395c02">log_help</a>(<a class="code hl_enumeration" href="namespaceflow_1_1log.html#a5c602384e6fe9d7642740ac2fae4ad04">log::Sev</a> sev = <a class="code hl_enumvalue" href="namespaceflow_1_1log.html#a5c602384e6fe9d7642740ac2fae4ad04ac238793326fae17afcc849e96b96e8e7">log::Sev::S_INFO</a>) <span class="keyword">const</span>;</div>
<div class="line"><a id="l00984" name="l00984"></a><span class="lineno">  984</span> </div>
<div class="line"><a id="l00985" name="l00985"></a><span class="lineno">  985</span>  <span class="comment">// Data.</span></div>
<div class="line"><a id="l00986" name="l00986"></a><span class="lineno">  986</span><span class="comment"></span> </div>
<div class="line"><a id="l00987" name="l00987"></a><span class="lineno">  987</span><span class="comment">  /// See `nickname` ctor arg.</span></div>
<div class="line"><a id="l00988" name="l00988"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a68da387dad566805b969aded698661cb">  988</a></span><span class="comment"></span>  <span class="keyword">const</span> std::string <a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#a68da387dad566805b969aded698661cb">m_nickname</a>;</div>
<div class="line"><a id="l00989" name="l00989"></a><span class="lineno">  989</span> </div>
<div class="line"><a id="l00990" name="l00990"></a><span class="lineno">  990</span><span class="keyword">private</span>:</div>
<div class="line"><a id="l00991" name="l00991"></a><span class="lineno">  991</span>  <span class="comment">// Types.</span></div>
<div class="line"><a id="l00992" name="l00992"></a><span class="lineno">  992</span><span class="comment"></span> </div>
<div class="line"><a id="l00993" name="l00993"></a><span class="lineno">  993</span><span class="comment">  /// Short-hand for `shared_ptr`-to-`void` type used to store variable-type values in internal containers.</span></div>
<div class="line"><a id="l00994" name="l00994"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a6f366f4070a90740e27d73029852e55f">  994</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classflow_1_1cfg_1_1Config__manager.html#a6f366f4070a90740e27d73029852e55f">Void_ptr</a> = boost::shared_ptr&lt;void&gt;;</div>
<div class="line"><a id="l00995" name="l00995"></a><span class="lineno">  995</span><span class="comment"></span> </div>
<div class="line"><a id="l00996" name="l00996"></a><span class="lineno">  996</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00997" name="l00997"></a><span class="lineno">  997</span><span class="comment">   * Useful at least in the context of multi-source (`commit == false`) `apply_*()` methods, this distinguishes</span></div>
<div class="line"><a id="l00998" name="l00998"></a><span class="lineno">  998</span><span class="comment">   * distinct possible public `apply_*()` methods.</span></div>
<div class="line"><a id="l00999" name="l00999"></a><span class="lineno">  999</span><span class="comment">   */</span></div>
<div class="line"><a id="l01000" name="l01000"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#aa0d03f4dcf7be2c21023c4073ac68b85"> 1000</a></span>  <span class="keyword">enum class</span> <a class="code hl_enumeration" href="classflow_1_1cfg_1_1Config__manager.html#aa0d03f4dcf7be2c21023c4073ac68b85">Update_type</a></div>
<div class="line"><a id="l01001" name="l01001"></a><span class="lineno"> 1001</span>  {<span class="comment"></span></div>
<div class="line"><a id="l01002" name="l01002"></a><span class="lineno"> 1002</span><span class="comment">    /// Indicates no `apply_*()` operation.</span></div>
<div class="line"><a id="l01003" name="l01003"></a><span class="lineno"> 1003</span><span class="comment"></span>    S_NONE,<span class="comment"></span></div>
<div class="line"><a id="l01004" name="l01004"></a><span class="lineno"> 1004</span><span class="comment">    /// Indicates apply_static().</span></div>
<div class="line"><a id="l01005" name="l01005"></a><span class="lineno"> 1005</span><span class="comment"></span>    S_STATIC,<span class="comment"></span></div>
<div class="line"><a id="l01006" name="l01006"></a><span class="lineno"> 1006</span><span class="comment">    /// Indicates apply_static_and_dynamic().</span></div>
<div class="line"><a id="l01007" name="l01007"></a><span class="lineno"> 1007</span><span class="comment"></span>    S_STATIC_AND_DYNAMIC,<span class="comment"></span></div>
<div class="line"><a id="l01008" name="l01008"></a><span class="lineno"> 1008</span><span class="comment">    /// Indicates apply_dynamic().</span></div>
<div class="line"><a id="l01009" name="l01009"></a><span class="lineno"> 1009</span><span class="comment"></span>    S_DYNAMIC</div>
<div class="line"><a id="l01010" name="l01010"></a><span class="lineno"> 1010</span>  }; <span class="comment">// enum class Update_type</span></div>
<div class="line"><a id="l01011" name="l01011"></a><span class="lineno"> 1011</span> </div>
<div class="line"><a id="l01012" name="l01012"></a><span class="lineno"> 1012</span>  <span class="comment">// Methods.</span></div>
<div class="line"><a id="l01013" name="l01013"></a><span class="lineno"> 1013</span><span class="comment"></span> </div>
<div class="line"><a id="l01014" name="l01014"></a><span class="lineno"> 1014</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01015" name="l01015"></a><span class="lineno"> 1015</span><span class="comment">   * Helper that obtains the Option_set in the slot `m_s_d_opt_sets[value_set_idx]`, which</span></div>
<div class="line"><a id="l01016" name="l01016"></a><span class="lineno"> 1016</span><span class="comment">   * stores an Option_set&lt;Value_set&gt;.</span></div>
<div class="line"><a id="l01017" name="l01017"></a><span class="lineno"> 1017</span><span class="comment">   *</span></div>
<div class="line"><a id="l01018" name="l01018"></a><span class="lineno"> 1018</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l01019" name="l01019"></a><span class="lineno"> 1019</span><span class="comment">   *         `S_d_value_set` in slot `value_set_idx`.</span></div>
<div class="line"><a id="l01020" name="l01020"></a><span class="lineno"> 1020</span><span class="comment">   * @param value_set_idx</span></div>
<div class="line"><a id="l01021" name="l01021"></a><span class="lineno"> 1021</span><span class="comment">   *        One of [0, 1, ..., #S_N_VALUE_SETS).</span></div>
<div class="line"><a id="l01022" name="l01022"></a><span class="lineno"> 1022</span><span class="comment">   * @return Pointer to the Option_set.</span></div>
<div class="line"><a id="l01023" name="l01023"></a><span class="lineno"> 1023</span><span class="comment">   */</span></div>
<div class="line"><a id="l01024" name="l01024"></a><span class="lineno"> 1024</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l01025" name="l01025"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a318e125f78cb7e471cae35e2651ab01f"> 1025</a></span>  <a class="code hl_class" href="classflow_1_1cfg_1_1Option__set.html">Option_set&lt;Value_set&gt;</a>* <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a318e125f78cb7e471cae35e2651ab01f">opt_set</a>(<span class="keywordtype">size_t</span> value_set_idx);</div>
<div class="line"><a id="l01026" name="l01026"></a><span class="lineno"> 1026</span><span class="comment"></span> </div>
<div class="line"><a id="l01027" name="l01027"></a><span class="lineno"> 1027</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01028" name="l01028"></a><span class="lineno"> 1028</span><span class="comment">   * Helper that obtains the baseline dynamic `Value_set` in the slot `m_d_baseline_value_sets[value_set_idx]`, which</span></div>
<div class="line"><a id="l01029" name="l01029"></a><span class="lineno"> 1029</span><span class="comment">   * stores a `Value_set`.</span></div>
<div class="line"><a id="l01030" name="l01030"></a><span class="lineno"> 1030</span><span class="comment">   *</span></div>
<div class="line"><a id="l01031" name="l01031"></a><span class="lineno"> 1031</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l01032" name="l01032"></a><span class="lineno"> 1032</span><span class="comment">   *         `S_d_value_set` in dynamic slot `d_value_set_idx`.</span></div>
<div class="line"><a id="l01033" name="l01033"></a><span class="lineno"> 1033</span><span class="comment">   * @param d_value_set_idx</span></div>
<div class="line"><a id="l01034" name="l01034"></a><span class="lineno"> 1034</span><span class="comment">   *        One of [0, 1, ..., #S_N_D_VALUE_SETS).</span></div>
<div class="line"><a id="l01035" name="l01035"></a><span class="lineno"> 1035</span><span class="comment">   * @return Pointer to the `Value_set`.</span></div>
<div class="line"><a id="l01036" name="l01036"></a><span class="lineno"> 1036</span><span class="comment">   */</span></div>
<div class="line"><a id="l01037" name="l01037"></a><span class="lineno"> 1037</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l01038" name="l01038"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#abe40d6451276e0d4c7c0867669791f9c"> 1038</a></span>  Value_set* <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#abe40d6451276e0d4c7c0867669791f9c">d_baseline_value_set</a>(<span class="keywordtype">size_t</span> d_value_set_idx);</div>
<div class="line"><a id="l01039" name="l01039"></a><span class="lineno"> 1039</span><span class="comment"></span> </div>
<div class="line"><a id="l01040" name="l01040"></a><span class="lineno"> 1040</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01041" name="l01041"></a><span class="lineno"> 1041</span><span class="comment">   * `const` overload of the other opt_set() helper.</span></div>
<div class="line"><a id="l01042" name="l01042"></a><span class="lineno"> 1042</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l01043" name="l01043"></a><span class="lineno"> 1043</span><span class="comment">   *         See other opt_set().</span></div>
<div class="line"><a id="l01044" name="l01044"></a><span class="lineno"> 1044</span><span class="comment">   * @param value_set_idx</span></div>
<div class="line"><a id="l01045" name="l01045"></a><span class="lineno"> 1045</span><span class="comment">   *        See other opt_set().</span></div>
<div class="line"><a id="l01046" name="l01046"></a><span class="lineno"> 1046</span><span class="comment">   * @return See other opt_set().</span></div>
<div class="line"><a id="l01047" name="l01047"></a><span class="lineno"> 1047</span><span class="comment">   */</span></div>
<div class="line"><a id="l01048" name="l01048"></a><span class="lineno"> 1048</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l01049" name="l01049"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#af54e2f1360834ece6fd06d34b387978c"> 1049</a></span>  <span class="keyword">const</span> <a class="code hl_class" href="classflow_1_1cfg_1_1Option__set.html">Option_set&lt;Value_set&gt;</a>* <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#af54e2f1360834ece6fd06d34b387978c">opt_set</a>(<span class="keywordtype">size_t</span> value_set_idx) <span class="keyword">const</span>;</div>
<div class="line"><a id="l01050" name="l01050"></a><span class="lineno"> 1050</span><span class="comment"></span> </div>
<div class="line"><a id="l01051" name="l01051"></a><span class="lineno"> 1051</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01052" name="l01052"></a><span class="lineno"> 1052</span><span class="comment">   * Helper that executes `opt_set-&gt;canonicalize_candidate()` or</span></div>
<div class="line"><a id="l01053" name="l01053"></a><span class="lineno"> 1053</span><span class="comment">   * `opt_set-&gt;reject_candidate()`.  Used in meta-programming.  Apply when parsing `*opt_set`,</span></div>
<div class="line"><a id="l01054" name="l01054"></a><span class="lineno"> 1054</span><span class="comment">   * assuming `commit == true`.</span></div>
<div class="line"><a id="l01055" name="l01055"></a><span class="lineno"> 1055</span><span class="comment">   *</span></div>
<div class="line"><a id="l01056" name="l01056"></a><span class="lineno"> 1056</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l01057" name="l01057"></a><span class="lineno"> 1057</span><span class="comment">   *         See opt_set().</span></div>
<div class="line"><a id="l01058" name="l01058"></a><span class="lineno"> 1058</span><span class="comment">   * @param opt_set</span></div>
<div class="line"><a id="l01059" name="l01059"></a><span class="lineno"> 1059</span><span class="comment">   *        An opt_set() result.</span></div>
<div class="line"><a id="l01060" name="l01060"></a><span class="lineno"> 1060</span><span class="comment">   * @param canonicalize_else_reject</span></div>
<div class="line"><a id="l01061" name="l01061"></a><span class="lineno"> 1061</span><span class="comment">   *        Specifies whether to... well, you know.</span></div>
<div class="line"><a id="l01062" name="l01062"></a><span class="lineno"> 1062</span><span class="comment">   * @param changed_or_null</span></div>
<div class="line"><a id="l01063" name="l01063"></a><span class="lineno"> 1063</span><span class="comment">   *        If not null and canonicalizing (not rejecting), `*changed_or_null` is set to whether</span></div>
<div class="line"><a id="l01064" name="l01064"></a><span class="lineno"> 1064</span><span class="comment">   *        the `canonicalize_candidate()` detected at least one option&#39;s value changed from the previous canonical</span></div>
<div class="line"><a id="l01065" name="l01065"></a><span class="lineno"> 1065</span><span class="comment">   *        state.</span></div>
<div class="line"><a id="l01066" name="l01066"></a><span class="lineno"> 1066</span><span class="comment">   */</span></div>
<div class="line"><a id="l01067" name="l01067"></a><span class="lineno"> 1067</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l01068" name="l01068"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a2c9f7e2dd8973d5ff191eee1c2394cae"> 1068</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a2c9f7e2dd8973d5ff191eee1c2394cae">option_set_canonicalize_or_reject</a>(<a class="code hl_class" href="classflow_1_1cfg_1_1Option__set.html">Option_set&lt;Value_set&gt;</a>* <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a318e125f78cb7e471cae35e2651ab01f">opt_set</a>,</div>
<div class="line"><a id="l01069" name="l01069"></a><span class="lineno"> 1069</span>                                         <span class="keywordtype">bool</span> canonicalize_else_reject, <span class="keywordtype">bool</span>* changed_or_null);</div>
<div class="line"><a id="l01070" name="l01070"></a><span class="lineno"> 1070</span><span class="comment"></span> </div>
<div class="line"><a id="l01071" name="l01071"></a><span class="lineno"> 1071</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01072" name="l01072"></a><span class="lineno"> 1072</span><span class="comment">   * Implements all apply_static() overloads.</span></div>
<div class="line"><a id="l01073" name="l01073"></a><span class="lineno"> 1073</span><span class="comment">   *</span></div>
<div class="line"><a id="l01074" name="l01074"></a><span class="lineno"> 1074</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l01075" name="l01075"></a><span class="lineno"> 1075</span><span class="comment">   *         See apply_static().</span></div>
<div class="line"><a id="l01076" name="l01076"></a><span class="lineno"> 1076</span><span class="comment">   * @param allow_invalid_defaults</span></div>
<div class="line"><a id="l01077" name="l01077"></a><span class="lineno"> 1077</span><span class="comment">   *        `true` if and only if #allow_invalid_defaults_tag_t used.</span></div>
<div class="line"><a id="l01078" name="l01078"></a><span class="lineno"> 1078</span><span class="comment">   * @param static_cfg_path</span></div>
<div class="line"><a id="l01079" name="l01079"></a><span class="lineno"> 1079</span><span class="comment">   *        See apply_static().</span></div>
<div class="line"><a id="l01080" name="l01080"></a><span class="lineno"> 1080</span><span class="comment">   * @param final_validator_func</span></div>
<div class="line"><a id="l01081" name="l01081"></a><span class="lineno"> 1081</span><span class="comment">   *        See apply_static().</span></div>
<div class="line"><a id="l01082" name="l01082"></a><span class="lineno"> 1082</span><span class="comment">   * @param commit</span></div>
<div class="line"><a id="l01083" name="l01083"></a><span class="lineno"> 1083</span><span class="comment">   *        See apply_static().</span></div>
<div class="line"><a id="l01084" name="l01084"></a><span class="lineno"> 1084</span><span class="comment">   * @return See apply_static().</span></div>
<div class="line"><a id="l01085" name="l01085"></a><span class="lineno"> 1085</span><span class="comment">   */</span></div>
<div class="line"><a id="l01086" name="l01086"></a><span class="lineno"> 1086</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l01087" name="l01087"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#ad320a74f83474c93cce385b0b9da887e"> 1087</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#ad320a74f83474c93cce385b0b9da887e">apply_static_impl</a>(<span class="keywordtype">bool</span> allow_invalid_defaults,</div>
<div class="line"><a id="l01088" name="l01088"></a><span class="lineno"> 1088</span>                         <span class="keyword">const</span> fs::path&amp; static_cfg_path,</div>
<div class="line"><a id="l01089" name="l01089"></a><span class="lineno"> 1089</span>                         <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;Value_set&gt;::Type</a>&amp;... final_validator_func,</div>
<div class="line"><a id="l01090" name="l01090"></a><span class="lineno"> 1090</span>                         <span class="keywordtype">bool</span> commit);</div>
<div class="line"><a id="l01091" name="l01091"></a><span class="lineno"> 1091</span><span class="comment"></span> </div>
<div class="line"><a id="l01092" name="l01092"></a><span class="lineno"> 1092</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01093" name="l01093"></a><span class="lineno"> 1093</span><span class="comment">   * Implements all apply_dynamic() overloads.</span></div>
<div class="line"><a id="l01094" name="l01094"></a><span class="lineno"> 1094</span><span class="comment">   *</span></div>
<div class="line"><a id="l01095" name="l01095"></a><span class="lineno"> 1095</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l01096" name="l01096"></a><span class="lineno"> 1096</span><span class="comment">   *         See apply_dynamic().</span></div>
<div class="line"><a id="l01097" name="l01097"></a><span class="lineno"> 1097</span><span class="comment">   * @param allow_invalid_defaults</span></div>
<div class="line"><a id="l01098" name="l01098"></a><span class="lineno"> 1098</span><span class="comment">   *        `true` if and only if #allow_invalid_defaults_tag_t used.</span></div>
<div class="line"><a id="l01099" name="l01099"></a><span class="lineno"> 1099</span><span class="comment">   * @param dynamic_cfg_path</span></div>
<div class="line"><a id="l01100" name="l01100"></a><span class="lineno"> 1100</span><span class="comment">   *        See apply_dynamic().</span></div>
<div class="line"><a id="l01101" name="l01101"></a><span class="lineno"> 1101</span><span class="comment">   * @param final_validator_func</span></div>
<div class="line"><a id="l01102" name="l01102"></a><span class="lineno"> 1102</span><span class="comment">   *        See apply_dynamic().</span></div>
<div class="line"><a id="l01103" name="l01103"></a><span class="lineno"> 1103</span><span class="comment">   * @param commit</span></div>
<div class="line"><a id="l01104" name="l01104"></a><span class="lineno"> 1104</span><span class="comment">   *        See apply_static().</span></div>
<div class="line"><a id="l01105" name="l01105"></a><span class="lineno"> 1105</span><span class="comment">   * @return See apply_dynamic().</span></div>
<div class="line"><a id="l01106" name="l01106"></a><span class="lineno"> 1106</span><span class="comment">   */</span></div>
<div class="line"><a id="l01107" name="l01107"></a><span class="lineno"> 1107</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l01108" name="l01108"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a8864e575c78251d3b8e109f86f29b703"> 1108</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a8864e575c78251d3b8e109f86f29b703">apply_dynamic_impl</a>(<span class="keywordtype">bool</span> allow_invalid_defaults,</div>
<div class="line"><a id="l01109" name="l01109"></a><span class="lineno"> 1109</span>                          <span class="keyword">const</span> fs::path&amp; dynamic_cfg_path,</div>
<div class="line"><a id="l01110" name="l01110"></a><span class="lineno"> 1110</span>                          <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;Value_set&gt;::Type</a>&amp;... final_validator_func,</div>
<div class="line"><a id="l01111" name="l01111"></a><span class="lineno"> 1111</span>                          <span class="keywordtype">bool</span> commit);</div>
<div class="line"><a id="l01112" name="l01112"></a><span class="lineno"> 1112</span><span class="comment"></span> </div>
<div class="line"><a id="l01113" name="l01113"></a><span class="lineno"> 1113</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01114" name="l01114"></a><span class="lineno"> 1114</span><span class="comment">   * Implements all apply_static_and_dynamic() overloads.</span></div>
<div class="line"><a id="l01115" name="l01115"></a><span class="lineno"> 1115</span><span class="comment">   *</span></div>
<div class="line"><a id="l01116" name="l01116"></a><span class="lineno"> 1116</span><span class="comment">   * @param allow_invalid_defaults</span></div>
<div class="line"><a id="l01117" name="l01117"></a><span class="lineno"> 1117</span><span class="comment">   *        `true` if and only if #allow_invalid_defaults_tag_t used.</span></div>
<div class="line"><a id="l01118" name="l01118"></a><span class="lineno"> 1118</span><span class="comment">   * @param cfg_path</span></div>
<div class="line"><a id="l01119" name="l01119"></a><span class="lineno"> 1119</span><span class="comment">   *        See apply_static_and_dynamic().</span></div>
<div class="line"><a id="l01120" name="l01120"></a><span class="lineno"> 1120</span><span class="comment">   * @param final_validator_func</span></div>
<div class="line"><a id="l01121" name="l01121"></a><span class="lineno"> 1121</span><span class="comment">   *        See apply_static_and_dynamic().</span></div>
<div class="line"><a id="l01122" name="l01122"></a><span class="lineno"> 1122</span><span class="comment">   * @param commit</span></div>
<div class="line"><a id="l01123" name="l01123"></a><span class="lineno"> 1123</span><span class="comment">   *        See apply_static_and_dynamic().</span></div>
<div class="line"><a id="l01124" name="l01124"></a><span class="lineno"> 1124</span><span class="comment">   * @return See apply_static_and_dynamic().</span></div>
<div class="line"><a id="l01125" name="l01125"></a><span class="lineno"> 1125</span><span class="comment">   */</span></div>
<div class="line"><a id="l01126" name="l01126"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a62619206c49b1b39c887162d8b6a2305"> 1126</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a62619206c49b1b39c887162d8b6a2305">apply_static_and_dynamic_impl</a>(<span class="keywordtype">bool</span> allow_invalid_defaults,</div>
<div class="line"><a id="l01127" name="l01127"></a><span class="lineno"> 1127</span>                                     <span class="keyword">const</span> fs::path&amp; cfg_path,</div>
<div class="line"><a id="l01128" name="l01128"></a><span class="lineno"> 1128</span>                                     <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;S_d_value_set&gt;::Type</a>&amp;... final_validator_func,</div>
<div class="line"><a id="l01129" name="l01129"></a><span class="lineno"> 1129</span>                                     <span class="keywordtype">bool</span> commit);</div>
<div class="line"><a id="l01130" name="l01130"></a><span class="lineno"> 1130</span><span class="comment"></span> </div>
<div class="line"><a id="l01131" name="l01131"></a><span class="lineno"> 1131</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01132" name="l01132"></a><span class="lineno"> 1132</span><span class="comment">   * Work-horse helper that parses either *all* static value sets *or* *all* dynamic value sets from the specified</span></div>
<div class="line"><a id="l01133" name="l01133"></a><span class="lineno"> 1133</span><span class="comment">   * file into #m_s_d_opt_sets and returns `true` if and only if all have succeeded.  (It stops on first failure.)</span></div>
<div class="line"><a id="l01134" name="l01134"></a><span class="lineno"> 1134</span><span class="comment">   * The canonicalize/reject step is not performed: only parsing and (if that worked) `final_validator_func()`.</span></div>
<div class="line"><a id="l01135" name="l01135"></a><span class="lineno"> 1135</span><span class="comment">   * Recall that `final_validator_func() == S_SKIP`, even though it will cause us to not have changed that `Value_set`&#39;s</span></div>
<div class="line"><a id="l01136" name="l01136"></a><span class="lineno"> 1136</span><span class="comment">   * Option_set::values_candidate(), is still considered success.</span></div>
<div class="line"><a id="l01137" name="l01137"></a><span class="lineno"> 1137</span><span class="comment">   *</span></div>
<div class="line"><a id="l01138" name="l01138"></a><span class="lineno"> 1138</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l01139" name="l01139"></a><span class="lineno"> 1139</span><span class="comment">   *         See apply_static() or apply_dynamic() depending on `dyn_else_st`.</span></div>
<div class="line"><a id="l01140" name="l01140"></a><span class="lineno"> 1140</span><span class="comment">   * @param dyn_else_st</span></div>
<div class="line"><a id="l01141" name="l01141"></a><span class="lineno"> 1141</span><span class="comment">   *        Basically whether apply_static() or apply_dynamic() was called.</span></div>
<div class="line"><a id="l01142" name="l01142"></a><span class="lineno"> 1142</span><span class="comment">   * @param cfg_path</span></div>
<div class="line"><a id="l01143" name="l01143"></a><span class="lineno"> 1143</span><span class="comment">   *        See apply_static() or apply_dynamic() depending on `dyn_else_st`.</span></div>
<div class="line"><a id="l01144" name="l01144"></a><span class="lineno"> 1144</span><span class="comment">   * @param all_opt_names_or_empty</span></div>
<div class="line"><a id="l01145" name="l01145"></a><span class="lineno"> 1145</span><span class="comment">   *        Empty if *any* option names may be present in file (such as to support dynamic config compatibility);</span></div>
<div class="line"><a id="l01146" name="l01146"></a><span class="lineno"> 1146</span><span class="comment">   *        otherwise must contain any option names that are allowed in this file (such as for apply_static()).</span></div>
<div class="line"><a id="l01147" name="l01147"></a><span class="lineno"> 1147</span><span class="comment">   * @param final_validator_func</span></div>
<div class="line"><a id="l01148" name="l01148"></a><span class="lineno"> 1148</span><span class="comment">   *        See apply_static() or apply_dynamic() depending on `dyn_else_st`.</span></div>
<div class="line"><a id="l01149" name="l01149"></a><span class="lineno"> 1149</span><span class="comment">   * @return See apply_static() or apply_dynamic() depending on `dyn_else_st`.</span></div>
<div class="line"><a id="l01150" name="l01150"></a><span class="lineno"> 1150</span><span class="comment">   */</span></div>
<div class="line"><a id="l01151" name="l01151"></a><span class="lineno"> 1151</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l01152" name="l01152"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#aa7785bcdb7fae9ae7ef6f1919b1f8045"> 1152</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#aa7785bcdb7fae9ae7ef6f1919b1f8045">apply_static_or_dynamic_impl</a></div>
<div class="line"><a id="l01153" name="l01153"></a><span class="lineno"> 1153</span>         (<span class="keywordtype">bool</span> dyn_else_st,</div>
<div class="line"><a id="l01154" name="l01154"></a><span class="lineno"> 1154</span>          <span class="keyword">const</span> fs::path&amp; cfg_path, <span class="keyword">const</span> boost::unordered_set&lt;std::string&gt;&amp; all_opt_names_or_empty,</div>
<div class="line"><a id="l01155" name="l01155"></a><span class="lineno"> 1155</span>          <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;Value_set&gt;::Type</a>&amp;... final_validator_func);</div>
<div class="line"><a id="l01156" name="l01156"></a><span class="lineno"> 1156</span><span class="comment"></span> </div>
<div class="line"><a id="l01157" name="l01157"></a><span class="lineno"> 1157</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01158" name="l01158"></a><span class="lineno"> 1158</span><span class="comment">   * Work-horse helper that parses into one given Option_set in #m_s_d_opt_sets (from opt_set()) from the specified</span></div>
<div class="line"><a id="l01159" name="l01159"></a><span class="lineno"> 1159</span><span class="comment">   * file and returns `true` if and only if successful.  The canonicalize/reject step is not performed: only</span></div>
<div class="line"><a id="l01160" name="l01160"></a><span class="lineno"> 1160</span><span class="comment">   * parsing and (if that worked) `final_validator_func()`.</span></div>
<div class="line"><a id="l01161" name="l01161"></a><span class="lineno"> 1161</span><span class="comment">   * Recall that `final_validator_func() == S_SKIP`, even though it will cause us to not have changed that `Value_set`&#39;s</span></div>
<div class="line"><a id="l01162" name="l01162"></a><span class="lineno"> 1162</span><span class="comment">   * Option_set::values_candidate(), is still considered success.</span></div>
<div class="line"><a id="l01163" name="l01163"></a><span class="lineno"> 1163</span><span class="comment">   *</span></div>
<div class="line"><a id="l01164" name="l01164"></a><span class="lineno"> 1164</span><span class="comment">   * If `opt_set-&gt;null() == true`, this completely no-ops and returns `true`.</span></div>
<div class="line"><a id="l01165" name="l01165"></a><span class="lineno"> 1165</span><span class="comment">   *</span></div>
<div class="line"><a id="l01166" name="l01166"></a><span class="lineno"> 1166</span><span class="comment">   * ### Effect of `skip_parsing` ###</span></div>
<div class="line"><a id="l01167" name="l01167"></a><span class="lineno"> 1167</span><span class="comment">   * It is a pointer.  If null (or if `opt_set-&gt;null() == true`), then the behavior is as written.</span></div>
<div class="line"><a id="l01168" name="l01168"></a><span class="lineno"> 1168</span><span class="comment">   *</span></div>
<div class="line"><a id="l01169" name="l01169"></a><span class="lineno"> 1169</span><span class="comment">   * If not null, then it has the following added effects -- used as of this writing by apply_dynamic():</span></div>
<div class="line"><a id="l01170" name="l01170"></a><span class="lineno"> 1170</span><span class="comment">   *   - If and only if, at entry to method, `*skip_parsing == true`, then:</span></div>
<div class="line"><a id="l01171" name="l01171"></a><span class="lineno"> 1171</span><span class="comment">   *     - The contents of the file shall be ignored, and `final_validator_func()` shall not be called;</span></div>
<div class="line"><a id="l01172" name="l01172"></a><span class="lineno"> 1172</span><span class="comment">   *       instead we act *as-if* the contents were individually valid, but `final_validator_func()` yielded `S_SKIP`.</span></div>
<div class="line"><a id="l01173" name="l01173"></a><span class="lineno"> 1173</span><span class="comment">   *   - On return from method: `*skip_parsing` shall be set to `true` if and only if:</span></div>
<div class="line"><a id="l01174" name="l01174"></a><span class="lineno"> 1174</span><span class="comment">   *     - `*skip_parsing = true` at entry to method; or else if</span></div>
<div class="line"><a id="l01175" name="l01175"></a><span class="lineno"> 1175</span><span class="comment">   *     - values in file were individually valid, but `final_validator_func()` yielded `S_SKIP`.</span></div>
<div class="line"><a id="l01176" name="l01176"></a><span class="lineno"> 1176</span><span class="comment">   *</span></div>
<div class="line"><a id="l01177" name="l01177"></a><span class="lineno"> 1177</span><span class="comment">   * More in English: To get the desired SKIP behavior, where a SKIPped `Value_set` also skips all subsequent</span></div>
<div class="line"><a id="l01178" name="l01178"></a><span class="lineno"> 1178</span><span class="comment">   * (but not preceding) ones, start with `bool skip_parsing = false`, then pass `&amp;skip_parsing` to each apply_impl().</span></div>
<div class="line"><a id="l01179" name="l01179"></a><span class="lineno"> 1179</span><span class="comment">   * (The `skip_parsing == nullptr` mode is still provided, in case it&#39;s useful for something later; as of this</span></div>
<div class="line"><a id="l01180" name="l01180"></a><span class="lineno"> 1180</span><span class="comment">   * writing all the public `apply_*()` APIs have `skip_parsing != nullptr`, but it could conceivably change.)</span></div>
<div class="line"><a id="l01181" name="l01181"></a><span class="lineno"> 1181</span><span class="comment">   *</span></div>
<div class="line"><a id="l01182" name="l01182"></a><span class="lineno"> 1182</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l01183" name="l01183"></a><span class="lineno"> 1183</span><span class="comment">   *         See opt_set().</span></div>
<div class="line"><a id="l01184" name="l01184"></a><span class="lineno"> 1184</span><span class="comment">   * @param opt_set</span></div>
<div class="line"><a id="l01185" name="l01185"></a><span class="lineno"> 1185</span><span class="comment">   *        An opt_set() result.</span></div>
<div class="line"><a id="l01186" name="l01186"></a><span class="lineno"> 1186</span><span class="comment">   * @param baseline_value_set_or_null</span></div>
<div class="line"><a id="l01187" name="l01187"></a><span class="lineno"> 1187</span><span class="comment">   *        If null then ignored; else -- just before attempting to parse and apply values from `cfg_path` -- we</span></div>
<div class="line"><a id="l01188" name="l01188"></a><span class="lineno"> 1188</span><span class="comment">   *        will set `*opt_set` to contain a copy of `Value_set *baseline_value_set_or_null`.  This is to ensure</span></div>
<div class="line"><a id="l01189" name="l01189"></a><span class="lineno"> 1189</span><span class="comment">   *        a consistent state after each dynamic config update as opposed to working incrementally.</span></div>
<div class="line"><a id="l01190" name="l01190"></a><span class="lineno"> 1190</span><span class="comment">   * @param cfg_path</span></div>
<div class="line"><a id="l01191" name="l01191"></a><span class="lineno"> 1191</span><span class="comment">   *        See apply_static_or_dynamic_impl().</span></div>
<div class="line"><a id="l01192" name="l01192"></a><span class="lineno"> 1192</span><span class="comment">   * @param all_opt_names_or_empty</span></div>
<div class="line"><a id="l01193" name="l01193"></a><span class="lineno"> 1193</span><span class="comment">   *        See apply_static_or_dynamic_impl().</span></div>
<div class="line"><a id="l01194" name="l01194"></a><span class="lineno"> 1194</span><span class="comment">   *        Technically this need not include the ones actually parsed by `*opt_set`; but including them is harmless</span></div>
<div class="line"><a id="l01195" name="l01195"></a><span class="lineno"> 1195</span><span class="comment">   *        (and may be helpful to the caller for simplicity).</span></div>
<div class="line"><a id="l01196" name="l01196"></a><span class="lineno"> 1196</span><span class="comment">   * @param final_validator_func</span></div>
<div class="line"><a id="l01197" name="l01197"></a><span class="lineno"> 1197</span><span class="comment">   *        See apply_static() or apply_dynamic() or apply_static_and_dynamic().</span></div>
<div class="line"><a id="l01198" name="l01198"></a><span class="lineno"> 1198</span><span class="comment">   * @param skip_parsing</span></div>
<div class="line"><a id="l01199" name="l01199"></a><span class="lineno"> 1199</span><span class="comment">   *        See above.  Recall it can be null.</span></div>
<div class="line"><a id="l01200" name="l01200"></a><span class="lineno"> 1200</span><span class="comment">   * @return `true` on success; `false` on failure.</span></div>
<div class="line"><a id="l01201" name="l01201"></a><span class="lineno"> 1201</span><span class="comment">   */</span></div>
<div class="line"><a id="l01202" name="l01202"></a><span class="lineno"> 1202</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l01203" name="l01203"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#ac416a9ecc83d4209b5b9767d01984aa3"> 1203</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#ac416a9ecc83d4209b5b9767d01984aa3">apply_impl</a>(<a class="code hl_class" href="classflow_1_1cfg_1_1Option__set.html">Option_set&lt;Value_set&gt;</a>* <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a318e125f78cb7e471cae35e2651ab01f">opt_set</a>, <span class="keyword">const</span> Value_set* baseline_value_set_or_null, <span class="keyword">const</span> fs::path&amp; cfg_path,</div>
<div class="line"><a id="l01204" name="l01204"></a><span class="lineno"> 1204</span>                  <span class="keyword">const</span> boost::unordered_set&lt;std::string&gt;&amp; all_opt_names_or_empty,</div>
<div class="line"><a id="l01205" name="l01205"></a><span class="lineno"> 1205</span>                  <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;Value_set&gt;::Type</a>&amp; final_validator_func,</div>
<div class="line"><a id="l01206" name="l01206"></a><span class="lineno"> 1206</span>                  <span class="keywordtype">bool</span>* skip_parsing);</div>
<div class="line"><a id="l01207" name="l01207"></a><span class="lineno"> 1207</span><span class="comment"></span> </div>
<div class="line"><a id="l01208" name="l01208"></a><span class="lineno"> 1208</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01209" name="l01209"></a><span class="lineno"> 1209</span><span class="comment">   * Helper for the top of `apply_*()` that guards against a call to `apply_Y()` following</span></div>
<div class="line"><a id="l01210" name="l01210"></a><span class="lineno"> 1210</span><span class="comment">   * `apply_X(commit == false) == true` without a reject_candidates() between them.  If this is detected, it</span></div>
<div class="line"><a id="l01211" name="l01211"></a><span class="lineno"> 1211</span><span class="comment">   * effectively &quot;inserts&quot; the &quot;missing&quot; reject_candidates() call -- plus an INFO message.</span></div>
<div class="line"><a id="l01212" name="l01212"></a><span class="lineno"> 1212</span><span class="comment">   *</span></div>
<div class="line"><a id="l01213" name="l01213"></a><span class="lineno"> 1213</span><span class="comment">   * Post-condition: #m_multi_src_update_in_progress equals Update_type::S_NONE.</span></div>
<div class="line"><a id="l01214" name="l01214"></a><span class="lineno"> 1214</span><span class="comment">   *</span></div>
<div class="line"><a id="l01215" name="l01215"></a><span class="lineno"> 1215</span><span class="comment">   * @param this_update_type</span></div>
<div class="line"><a id="l01216" name="l01216"></a><span class="lineno"> 1216</span><span class="comment">   *        The type (not NONE, or behavior undefined -- assert may trip) of `apply_*()` calling us.</span></div>
<div class="line"><a id="l01217" name="l01217"></a><span class="lineno"> 1217</span><span class="comment">   */</span></div>
<div class="line"><a id="l01218" name="l01218"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#abe9d2c5d3a9747a26a4e6233a0f1feed"> 1218</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#abe9d2c5d3a9747a26a4e6233a0f1feed">reject_candidates_if_update_type_changed</a>(<a class="code hl_enumeration" href="classflow_1_1cfg_1_1Config__manager.html#aa0d03f4dcf7be2c21023c4073ac68b85">Update_type</a> this_update_type);</div>
<div class="line"><a id="l01219" name="l01219"></a><span class="lineno"> 1219</span><span class="comment"></span> </div>
<div class="line"><a id="l01220" name="l01220"></a><span class="lineno"> 1220</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01221" name="l01221"></a><span class="lineno"> 1221</span><span class="comment">   * Little helper that, having assumed #m_d_value_sets_mutex is locked, makes a newly allocated copy of the canonical</span></div>
<div class="line"><a id="l01222" name="l01222"></a><span class="lineno"> 1222</span><span class="comment">   * dynamic config at the given slot and saves a (new) ref-counted pointer to it in the proper #m_d_value_sets slot.</span></div>
<div class="line"><a id="l01223" name="l01223"></a><span class="lineno"> 1223</span><span class="comment">   *</span></div>
<div class="line"><a id="l01224" name="l01224"></a><span class="lineno"> 1224</span><span class="comment">   * @tparam Value_set</span></div>
<div class="line"><a id="l01225" name="l01225"></a><span class="lineno"> 1225</span><span class="comment">   *         See opt_set().</span></div>
<div class="line"><a id="l01226" name="l01226"></a><span class="lineno"> 1226</span><span class="comment">   * @param opt_set</span></div>
<div class="line"><a id="l01227" name="l01227"></a><span class="lineno"> 1227</span><span class="comment">   *        An opt_set() result (dynamic slot).</span></div>
<div class="line"><a id="l01228" name="l01228"></a><span class="lineno"> 1228</span><span class="comment">   * @param d_value_set_idx</span></div>
<div class="line"><a id="l01229" name="l01229"></a><span class="lineno"> 1229</span><span class="comment">   *        One of [0, 1, ..., #S_N_D_VALUE_SETS).</span></div>
<div class="line"><a id="l01230" name="l01230"></a><span class="lineno"> 1230</span><span class="comment">   */</span></div>
<div class="line"><a id="l01231" name="l01231"></a><span class="lineno"> 1231</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l01232" name="l01232"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a859a36cccd8196d9648f67de8656360a"> 1232</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a859a36cccd8196d9648f67de8656360a">save_dynamic_value_set_locked</a>(<a class="code hl_class" href="classflow_1_1cfg_1_1Option__set.html">Option_set&lt;Value_set&gt;</a>* <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a318e125f78cb7e471cae35e2651ab01f">opt_set</a>, <span class="keywordtype">size_t</span> d_value_set_idx);</div>
<div class="line"><a id="l01233" name="l01233"></a><span class="lineno"> 1233</span><span class="comment"></span> </div>
<div class="line"><a id="l01234" name="l01234"></a><span class="lineno"> 1234</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01235" name="l01235"></a><span class="lineno"> 1235</span><span class="comment">   * Invokes the registered listeners for the given dynamic config slot (synchronously).</span></div>
<div class="line"><a id="l01236" name="l01236"></a><span class="lineno"> 1236</span><span class="comment">   *</span></div>
<div class="line"><a id="l01237" name="l01237"></a><span class="lineno"> 1237</span><span class="comment">   * @param d_value_set_idx</span></div>
<div class="line"><a id="l01238" name="l01238"></a><span class="lineno"> 1238</span><span class="comment">   *        One of [0,1, ... #S_N_D_VALUE_SETS).</span></div>
<div class="line"><a id="l01239" name="l01239"></a><span class="lineno"> 1239</span><span class="comment">   * @param init</span></div>
<div class="line"><a id="l01240" name="l01240"></a><span class="lineno"> 1240</span><span class="comment">   *        For logging (as of this writing): whether this is due to the initial parsing of this dynamic config slot</span></div>
<div class="line"><a id="l01241" name="l01241"></a><span class="lineno"> 1241</span><span class="comment">   *        or a subsequent change.</span></div>
<div class="line"><a id="l01242" name="l01242"></a><span class="lineno"> 1242</span><span class="comment">   */</span></div>
<div class="line"><a id="l01243" name="l01243"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a57140907e43a66705625d391e85e3c52"> 1243</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a57140907e43a66705625d391e85e3c52">invoke_dynamic_change_listeners</a>(<span class="keywordtype">size_t</span> d_value_set_idx, <span class="keywordtype">bool</span> init) <span class="keyword">const</span>;</div>
<div class="line"><a id="l01244" name="l01244"></a><span class="lineno"> 1244</span><span class="comment"></span> </div>
<div class="line"><a id="l01245" name="l01245"></a><span class="lineno"> 1245</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01246" name="l01246"></a><span class="lineno"> 1246</span><span class="comment">   * Helper of state_to_ostream() for #m_s_d_opt_sets slot `value_set_idx`.</span></div>
<div class="line"><a id="l01247" name="l01247"></a><span class="lineno"> 1247</span><span class="comment">   *</span></div>
<div class="line"><a id="l01248" name="l01248"></a><span class="lineno"> 1248</span><span class="comment">   * @param value_set_idx</span></div>
<div class="line"><a id="l01249" name="l01249"></a><span class="lineno"> 1249</span><span class="comment">   *        One of [0, 1, ..., #S_N_VALUE_SETS).</span></div>
<div class="line"><a id="l01250" name="l01250"></a><span class="lineno"> 1250</span><span class="comment">   * @param os</span></div>
<div class="line"><a id="l01251" name="l01251"></a><span class="lineno"> 1251</span><span class="comment">   *        See state_to_ostream().</span></div>
<div class="line"><a id="l01252" name="l01252"></a><span class="lineno"> 1252</span><span class="comment">   */</span></div>
<div class="line"><a id="l01253" name="l01253"></a><span class="lineno"> 1253</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l01254" name="l01254"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#afbf1eca924be81654eaa4140814a816f"> 1254</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#afbf1eca924be81654eaa4140814a816f">state_to_ostream_impl</a>(<span class="keywordtype">size_t</span> value_set_idx, std::ostream&amp; os) <span class="keyword">const</span>;</div>
<div class="line"><a id="l01255" name="l01255"></a><span class="lineno"> 1255</span><span class="comment"></span> </div>
<div class="line"><a id="l01256" name="l01256"></a><span class="lineno"> 1256</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01257" name="l01257"></a><span class="lineno"> 1257</span><span class="comment">   * Helper of help_to_ostream() for #m_s_d_opt_sets slot `value_set_idx`.</span></div>
<div class="line"><a id="l01258" name="l01258"></a><span class="lineno"> 1258</span><span class="comment">   *</span></div>
<div class="line"><a id="l01259" name="l01259"></a><span class="lineno"> 1259</span><span class="comment">   * @param value_set_idx</span></div>
<div class="line"><a id="l01260" name="l01260"></a><span class="lineno"> 1260</span><span class="comment">   *        One of [0, 1, ..., #S_N_VALUE_SETS).</span></div>
<div class="line"><a id="l01261" name="l01261"></a><span class="lineno"> 1261</span><span class="comment">   * @param os</span></div>
<div class="line"><a id="l01262" name="l01262"></a><span class="lineno"> 1262</span><span class="comment">   *        See help_to_ostream().</span></div>
<div class="line"><a id="l01263" name="l01263"></a><span class="lineno"> 1263</span><span class="comment">   */</span></div>
<div class="line"><a id="l01264" name="l01264"></a><span class="lineno"> 1264</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l01265" name="l01265"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a8be0e0697c1b106c7170795ee4a225e8"> 1265</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a8be0e0697c1b106c7170795ee4a225e8">help_to_ostream_impl</a>(<span class="keywordtype">size_t</span> value_set_idx, std::ostream&amp; os) <span class="keyword">const</span>;</div>
<div class="line"><a id="l01266" name="l01266"></a><span class="lineno"> 1266</span> </div>
<div class="line"><a id="l01267" name="l01267"></a><span class="lineno"> 1267</span>  <span class="comment">// Data.</span></div>
<div class="line"><a id="l01268" name="l01268"></a><span class="lineno"> 1268</span><span class="comment"></span> </div>
<div class="line"><a id="l01269" name="l01269"></a><span class="lineno"> 1269</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01270" name="l01270"></a><span class="lineno"> 1270</span><span class="comment">   * The static and dynamic value sets, in the same order as the #S_N_VALUE_SETS</span></div>
<div class="line"><a id="l01271" name="l01271"></a><span class="lineno"> 1271</span><span class="comment">   * `S_d_value_set` template args, the specific type for each slot being: `Option_set&lt;S_d_value_set&gt;`.</span></div>
<div class="line"><a id="l01272" name="l01272"></a><span class="lineno"> 1272</span><span class="comment">   * This is the main data store managed by Config_manager.  Each static `S_d_value_set` (the even slots) is the</span></div>
<div class="line"><a id="l01273" name="l01273"></a><span class="lineno"> 1273</span><span class="comment">   * entirety of data having to do with that piece of static config.  Each dynamic `S_d_value_set` (the odd slots) is</span></div>
<div class="line"><a id="l01274" name="l01274"></a><span class="lineno"> 1274</span><span class="comment">   * the *canonical* dynamic config; and a pointer to a *copy* thereof is also maintained in #m_d_value_sets.</span></div>
<div class="line"><a id="l01275" name="l01275"></a><span class="lineno"> 1275</span><span class="comment">   *</span></div>
<div class="line"><a id="l01276" name="l01276"></a><span class="lineno"> 1276</span><span class="comment">   * The slots, in order, are hence:</span></div>
<div class="line"><a id="l01277" name="l01277"></a><span class="lineno"> 1277</span><span class="comment">   *   - Index [0]: static slot 0,</span></div>
<div class="line"><a id="l01278" name="l01278"></a><span class="lineno"> 1278</span><span class="comment">   *   - Index [1]: dynamic slot 0,</span></div>
<div class="line"><a id="l01279" name="l01279"></a><span class="lineno"> 1279</span><span class="comment">   *   - Index [2]: static slot 1,</span></div>
<div class="line"><a id="l01280" name="l01280"></a><span class="lineno"> 1280</span><span class="comment">   *   - Index [3]: dynamic slot 1,</span></div>
<div class="line"><a id="l01281" name="l01281"></a><span class="lineno"> 1281</span><span class="comment">   *   - ...</span></div>
<div class="line"><a id="l01282" name="l01282"></a><span class="lineno"> 1282</span><span class="comment">   *   - Index [`.size() - 2`]: static slot `S_N_S_VALUE_SETS - 1`.</span></div>
<div class="line"><a id="l01283" name="l01283"></a><span class="lineno"> 1283</span><span class="comment">   *   - Index [`.size() - 1`]: dynamic slot `S_N_D_VALUE_SETS - 1`.</span></div>
<div class="line"><a id="l01284" name="l01284"></a><span class="lineno"> 1284</span><span class="comment">   *</span></div>
<div class="line"><a id="l01285" name="l01285"></a><span class="lineno"> 1285</span><span class="comment">   * The actual type stored is `shared_ptr&lt;void&gt;`, with each slot&#39;s held pointer actually being an</span></div>
<div class="line"><a id="l01286" name="l01286"></a><span class="lineno"> 1286</span><span class="comment">   * `Option_set&lt;S_d_value_set&gt;*`.</span></div>
<div class="line"><a id="l01287" name="l01287"></a><span class="lineno"> 1287</span><span class="comment">   * opt_set() obtains the actual `Option_set&lt;&gt;` at a given slot, performing the required casting.</span></div>
<div class="line"><a id="l01288" name="l01288"></a><span class="lineno"> 1288</span><span class="comment">   *</span></div>
<div class="line"><a id="l01289" name="l01289"></a><span class="lineno"> 1289</span><span class="comment">   * ### Rationale ###</span></div>
<div class="line"><a id="l01290" name="l01290"></a><span class="lineno"> 1290</span><span class="comment">   * Why use an array of `shared_ptr&lt;void&gt;`, which requires a `static_cast` anytime we need to actually</span></div>
<div class="line"><a id="l01291" name="l01291"></a><span class="lineno"> 1291</span><span class="comment">   * access a config set?  The more compile-time/meta-programm-y approach I (ygoldfel) could conceive of was to use</span></div>
<div class="line"><a id="l01292" name="l01292"></a><span class="lineno"> 1292</span><span class="comment">   * `tuple&lt;S_d_value_set...&gt;`.  That would be quite elegant and lightning-fast (though compilation might be very slow).</span></div>
<div class="line"><a id="l01293" name="l01293"></a><span class="lineno"> 1293</span><span class="comment">   * However then, if I understand correctly, that would prevent any kind of runtime iteration through them.</span></div>
<div class="line"><a id="l01294" name="l01294"></a><span class="lineno"> 1294</span><span class="comment">   * This might be absolutely fine, if every slot were treated identically, but in the current setup it&#39;s</span></div>
<div class="line"><a id="l01295" name="l01295"></a><span class="lineno"> 1295</span><span class="comment">   * static, dynamic, static, dynamic, ....  Therefore, by moving some processing to runtime instead of compile-time</span></div>
<div class="line"><a id="l01296" name="l01296"></a><span class="lineno"> 1296</span><span class="comment">   * we gain flexibility.  (Do note my disclaimer in Implementation section in class doc header -- indicating this is</span></div>
<div class="line"><a id="l01297" name="l01297"></a><span class="lineno"> 1297</span><span class="comment">   * my first foray into advanced meta-programming like this.  So perhaps I lack imagination/experience.)</span></div>
<div class="line"><a id="l01298" name="l01298"></a><span class="lineno"> 1298</span><span class="comment">   *</span></div>
<div class="line"><a id="l01299" name="l01299"></a><span class="lineno"> 1299</span><span class="comment">   * So then `shared_ptr&lt;void&gt;` actually stores an `S_d_value_set*` -- `S_d_value_set` being a different type for</span></div>
<div class="line"><a id="l01300" name="l01300"></a><span class="lineno"> 1300</span><span class="comment">   * each slot in the array.  This uses the type erasure pattern of standard C++ smart pointers, wherein because</span></div>
<div class="line"><a id="l01301" name="l01301"></a><span class="lineno"> 1301</span><span class="comment">   * `static_cast&lt;void*&gt;(T*)` is allowed for any type `T`, `shared_ptr&lt;void&gt;` deleter will properly `delete` the `T*`,</span></div>
<div class="line"><a id="l01302" name="l01302"></a><span class="lineno"> 1302</span><span class="comment">   * as long as the `shared_ptr` ctor is passed a `T*` raw pointer.  Do note this is type-safe only if our code</span></div>
<div class="line"><a id="l01303" name="l01303"></a><span class="lineno"> 1303</span><span class="comment">   * knows to cast to the proper `T*` when the pointer is accessed.</span></div>
<div class="line"><a id="l01304" name="l01304"></a><span class="lineno"> 1304</span><span class="comment">   *</span></div>
<div class="line"><a id="l01305" name="l01305"></a><span class="lineno"> 1305</span><span class="comment">   * Why `shared_ptr` -- not `unique_ptr` (which is nominally faster in that there&#39;s no ref-counting)?  Answer:</span></div>
<div class="line"><a id="l01306" name="l01306"></a><span class="lineno"> 1306</span><span class="comment">   * `unique_ptr` is apparently deliberately simple and lacks aliasing and type-erasure constructors.</span></div>
<div class="line"><a id="l01307" name="l01307"></a><span class="lineno"> 1307</span><span class="comment">   * `unique_ptr&lt;T&gt;` can only delete a `T` with the default deleter; and `T` being `void` therefore won&#39;t compile.</span></div>
<div class="line"><a id="l01308" name="l01308"></a><span class="lineno"> 1308</span><span class="comment">   * It is probably possible to hack it with a custom deleter -- but this seemed like overkill, as these handles</span></div>
<div class="line"><a id="l01309" name="l01309"></a><span class="lineno"> 1309</span><span class="comment">   * are never used except inside an `array`, so reference counting shouldn&#39;t even happen and thus cost any perf</span></div>
<div class="line"><a id="l01310" name="l01310"></a><span class="lineno"> 1310</span><span class="comment">   * cycles outside of `*this` ctor and dtor.</span></div>
<div class="line"><a id="l01311" name="l01311"></a><span class="lineno"> 1311</span><span class="comment">   *</span></div>
<div class="line"><a id="l01312" name="l01312"></a><span class="lineno"> 1312</span><span class="comment">   * An alternative, which is somewhat more type-safe in that it would have resulted in an RTTI exception if the</span></div>
<div class="line"><a id="l01313" name="l01313"></a><span class="lineno"> 1313</span><span class="comment">   * wrong type-cast were used on the stored value, was `any`.  However `any` is slower, involving `virtual` lookups</span></div>
<div class="line"><a id="l01314" name="l01314"></a><span class="lineno"> 1314</span><span class="comment">   * (at least in a naive implementation of `any`).</span></div>
<div class="line"><a id="l01315" name="l01315"></a><span class="lineno"> 1315</span><span class="comment">   */</span></div>
<div class="line"><a id="l01316" name="l01316"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a4e724d9d455ea31439c6832d0bc645bd"> 1316</a></span>  boost::array&lt;Void_ptr, S_N_VALUE_SETS&gt; <a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#a4e724d9d455ea31439c6832d0bc645bd">m_s_d_opt_sets</a>;</div>
<div class="line"><a id="l01317" name="l01317"></a><span class="lineno"> 1317</span><span class="comment"></span> </div>
<div class="line"><a id="l01318" name="l01318"></a><span class="lineno"> 1318</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01319" name="l01319"></a><span class="lineno"> 1319</span><span class="comment">   * The baseline dynamic value sets, in the same order as #S_N_D_VALUE_SETS *dynamic*</span></div>
<div class="line"><a id="l01320" name="l01320"></a><span class="lineno"> 1320</span><span class="comment">   * `S_d_value_set` template args, the specific type for each slot being `S_d_value_set`.</span></div>
<div class="line"><a id="l01321" name="l01321"></a><span class="lineno"> 1321</span><span class="comment">   *</span></div>
<div class="line"><a id="l01322" name="l01322"></a><span class="lineno"> 1322</span><span class="comment">   * The actual type stored is `shared_ptr&lt;void&gt;`, with each slot&#39;s held pointer actually being `S_d_value_set*`.</span></div>
<div class="line"><a id="l01323" name="l01323"></a><span class="lineno"> 1323</span><span class="comment">   * The same type erasure technique used in #m_s_d_opt_sets is used here.</span></div>
<div class="line"><a id="l01324" name="l01324"></a><span class="lineno"> 1324</span><span class="comment">   * d_baseline_value_set() obtains the actual `S_d_value_set` at a given slot, performing the required casting.</span></div>
<div class="line"><a id="l01325" name="l01325"></a><span class="lineno"> 1325</span><span class="comment">   *</span></div>
<div class="line"><a id="l01326" name="l01326"></a><span class="lineno"> 1326</span><span class="comment">   * A null pointer is stored if the corresponding Option_set in #m_s_d_opt_sets is `null()` (a placeholder with 0</span></div>
<div class="line"><a id="l01327" name="l01327"></a><span class="lineno"> 1327</span><span class="comment">   * settings).</span></div>
<div class="line"><a id="l01328" name="l01328"></a><span class="lineno"> 1328</span><span class="comment">   *</span></div>
<div class="line"><a id="l01329" name="l01329"></a><span class="lineno"> 1329</span><span class="comment">   * ### Rationale / explanation ###</span></div>
<div class="line"><a id="l01330" name="l01330"></a><span class="lineno"> 1330</span><span class="comment">   * Suppose a dynamic `Value_set` is to be parsed from file F potentially repeatedly, as dynamic updates come in.</span></div>
<div class="line"><a id="l01331" name="l01331"></a><span class="lineno"> 1331</span><span class="comment">   * Then its Option_set from `m_s_d_opt_sets[]` would `parse_config_file(F)` each time.  However, if that is all</span></div>
<div class="line"><a id="l01332" name="l01332"></a><span class="lineno"> 1332</span><span class="comment">   * we did, then the updates would stack on top of each other incrementally: if one looks at F&#39;s contents at a given</span></div>
<div class="line"><a id="l01333" name="l01333"></a><span class="lineno"> 1333</span><span class="comment">   * time, one cannot tell what the `Value_set` in memory would contain upon parsing it; it would depend on any</span></div>
<div class="line"><a id="l01334" name="l01334"></a><span class="lineno"> 1334</span><span class="comment">   * preceding updates.  That&#39;s bad: the resulting memory `Value_set` must be consistent, regardless of what</span></div>
<div class="line"><a id="l01335" name="l01335"></a><span class="lineno"> 1335</span><span class="comment">   * F contained in preceding updates.  Therefore, a certain *baseline* state for that `Value_set` must be loaded</span></div>
<div class="line"><a id="l01336" name="l01336"></a><span class="lineno"> 1336</span><span class="comment">   * into the Option_set just before the Option_set::parse_config_file() call in each update.</span></div>
<div class="line"><a id="l01337" name="l01337"></a><span class="lineno"> 1337</span><span class="comment">   *</span></div>
<div class="line"><a id="l01338" name="l01338"></a><span class="lineno"> 1338</span><span class="comment">   * This stores each dynamic slot&#39;s baseline `Value_set` state to load as just described.</span></div>
<div class="line"><a id="l01339" name="l01339"></a><span class="lineno"> 1339</span><span class="comment">   *</span></div>
<div class="line"><a id="l01340" name="l01340"></a><span class="lineno"> 1340</span><span class="comment">   * After construction this payload is just the default-cted `Value_set()`.  If the user chooses to execute</span></div>
<div class="line"><a id="l01341" name="l01341"></a><span class="lineno"> 1341</span><span class="comment">   * a one-time apply_static_and_dynamic(), then that payload is replaced by the state after having parsed that</span></div>
<div class="line"><a id="l01342" name="l01342"></a><span class="lineno"> 1342</span><span class="comment">   * baseline state.  Note, for context, that apply_static_and_dynamic() would be presumably loading *not*</span></div>
<div class="line"><a id="l01343" name="l01343"></a><span class="lineno"> 1343</span><span class="comment">   * from file F (which can change repeatedly, as dynamic updates come in) but some other file B, typically storing</span></div>
<div class="line"><a id="l01344" name="l01344"></a><span class="lineno"> 1344</span><span class="comment">   * both static value sets&#39; contents as well as the baseline dynamic value sets&#39;.</span></div>
<div class="line"><a id="l01345" name="l01345"></a><span class="lineno"> 1345</span><span class="comment">   */</span></div>
<div class="line"><a id="l01346" name="l01346"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a46a8745fe3fe54ede7f664b0a4cd8357"> 1346</a></span>  boost::array&lt;Void_ptr, S_N_D_VALUE_SETS&gt; <a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#a46a8745fe3fe54ede7f664b0a4cd8357">m_d_baseline_value_sets</a>;</div>
<div class="line"><a id="l01347" name="l01347"></a><span class="lineno"> 1347</span><span class="comment"></span> </div>
<div class="line"><a id="l01348" name="l01348"></a><span class="lineno"> 1348</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01349" name="l01349"></a><span class="lineno"> 1349</span><span class="comment">   * The dynamic config ref-counted handles returned by all_dynamic_values().  Each one is a ref-counted pointer</span></div>
<div class="line"><a id="l01350" name="l01350"></a><span class="lineno"> 1350</span><span class="comment">   * to an immutable *copy* of the canonical `S_d_value_set` in that *dynamic* slot of #m_s_d_opt_sets</span></div>
<div class="line"><a id="l01351" name="l01351"></a><span class="lineno"> 1351</span><span class="comment">   * (namely `m_s_d_opt_sets[2 * d_idx + 1]`, where `d_idx` is in [0, 1, ..., #S_N_D_VALUE_SETS)).</span></div>
<div class="line"><a id="l01352" name="l01352"></a><span class="lineno"> 1352</span><span class="comment">   *</span></div>
<div class="line"><a id="l01353" name="l01353"></a><span class="lineno"> 1353</span><span class="comment">   * The actual type stored is `shared_ptr&lt;void&gt;`, with each slot&#39;s held pointer actually being</span></div>
<div class="line"><a id="l01354" name="l01354"></a><span class="lineno"> 1354</span><span class="comment">   * `S_d_value_set::Const_ptr*`.  The same type erasure technique used in #m_s_d_opt_sets is used here.</span></div>
<div class="line"><a id="l01355" name="l01355"></a><span class="lineno"> 1355</span><span class="comment">   *</span></div>
<div class="line"><a id="l01356" name="l01356"></a><span class="lineno"> 1356</span><span class="comment">   * Protected by #m_d_value_sets_mutex.</span></div>
<div class="line"><a id="l01357" name="l01357"></a><span class="lineno"> 1357</span><span class="comment">   *</span></div>
<div class="line"><a id="l01358" name="l01358"></a><span class="lineno"> 1358</span><span class="comment">   * apply_dynamic() and apply_static_and_dynamic() set these; all_dynamic_values() and dynamic_values() get them.</span></div>
<div class="line"><a id="l01359" name="l01359"></a><span class="lineno"> 1359</span><span class="comment">   *</span></div>
<div class="line"><a id="l01360" name="l01360"></a><span class="lineno"> 1360</span><span class="comment">   * ### Rationale ###</span></div>
<div class="line"><a id="l01361" name="l01361"></a><span class="lineno"> 1361</span><span class="comment">   * Why is this necessary?  Why not just expose a pointer to immutable `S_d_value_set` directly inside</span></div>
<div class="line"><a id="l01362" name="l01362"></a><span class="lineno"> 1362</span><span class="comment">   * `m_s_d_opt_sets[d_idx]` as we do (via static_values() and all_static_values()) for the static config?  Answer:</span></div>
<div class="line"><a id="l01363" name="l01363"></a><span class="lineno"> 1363</span><span class="comment">   * Because with dynamic config it is important that the user be able to retain (if even for a short time, perhaps to</span></div>
<div class="line"><a id="l01364" name="l01364"></a><span class="lineno"> 1364</span><span class="comment">   * complete some operation -- *during* which `*this` might process a dynamic update via apply_dynamic()) an immutable</span></div>
<div class="line"><a id="l01365" name="l01365"></a><span class="lineno"> 1365</span><span class="comment">   * `S_d_value_set`.  Since by definition that&#39;s not possible with dynamic config updates, we must create a copy.  At</span></div>
<div class="line"><a id="l01366" name="l01366"></a><span class="lineno"> 1366</span><span class="comment">   * that point it becomes natural to wrap it in a `shared_ptr`, so that only *one* copy is necessary in the entire</span></div>
<div class="line"><a id="l01367" name="l01367"></a><span class="lineno"> 1367</span><span class="comment">   * application -- and it&#39;ll disappear once (1) the canonical config has been updated, replacing `m_d_value_sets[]`,</span></div>
<div class="line"><a id="l01368" name="l01368"></a><span class="lineno"> 1368</span><span class="comment">   * and (2) all user code has dropped the remaining refs to it.</span></div>
<div class="line"><a id="l01369" name="l01369"></a><span class="lineno"> 1369</span><span class="comment">   *</span></div>
<div class="line"><a id="l01370" name="l01370"></a><span class="lineno"> 1370</span><span class="comment">   * The ref-counted-pointer-to-dynamic-config is a common pattern.  The only thing we add that might not be obvious</span></div>
<div class="line"><a id="l01371" name="l01371"></a><span class="lineno"> 1371</span><span class="comment">   * is having the canonical copy be separate from the one we expose via the pointer publicly.  The latter is</span></div>
<div class="line"><a id="l01372" name="l01372"></a><span class="lineno"> 1372</span><span class="comment">   * the natural consequence of the fact that the `Value_set` managed by `Option_set&lt;Value_set&gt;` lives inside</span></div>
<div class="line"><a id="l01373" name="l01373"></a><span class="lineno"> 1373</span><span class="comment">   * the `Option_set` and is not wrapped by any `shared_ptr`.  However Option_set::mutable_values_copy() does provide</span></div>
<div class="line"><a id="l01374" name="l01374"></a><span class="lineno"> 1374</span><span class="comment">   * easy access to a `shared_ptr`-wrapped copy thereof... so we use it.  The perf cost is that of a value-set</span></div>
<div class="line"><a id="l01375" name="l01375"></a><span class="lineno"> 1375</span><span class="comment">   * copy at apply_dynamic() time which is negligible in the grand scheme of things.</span></div>
<div class="line"><a id="l01376" name="l01376"></a><span class="lineno"> 1376</span><span class="comment">   */</span></div>
<div class="line"><a id="l01377" name="l01377"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a447aa1d42bc9f40af92ce5968c0edc82"> 1377</a></span>  boost::array&lt;Void_ptr, S_N_D_VALUE_SETS&gt; <a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#a447aa1d42bc9f40af92ce5968c0edc82">m_d_value_sets</a>;</div>
<div class="line"><a id="l01378" name="l01378"></a><span class="lineno"> 1378</span><span class="comment"></span> </div>
<div class="line"><a id="l01379" name="l01379"></a><span class="lineno"> 1379</span><span class="comment">  /// Mutex protecting #m_d_value_sets.</span></div>
<div class="line"><a id="l01380" name="l01380"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#ab8463fe083d97fd4d4b49f7265726d2c"> 1380</a></span><span class="comment"></span>  <span class="keyword">mutable</span> <a class="code hl_typedef" href="namespaceflow_1_1util.html#add6ade273326f27eaf9bfd170a909626">util::Mutex_non_recursive</a> <a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#ab8463fe083d97fd4d4b49f7265726d2c">m_d_value_sets_mutex</a>;</div>
<div class="line"><a id="l01381" name="l01381"></a><span class="lineno"> 1381</span><span class="comment"></span> </div>
<div class="line"><a id="l01382" name="l01382"></a><span class="lineno"> 1382</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01383" name="l01383"></a><span class="lineno"> 1383</span><span class="comment">   * List of callbacks to execute after #m_d_value_sets members (the pointers) are next assigned: one per</span></div>
<div class="line"><a id="l01384" name="l01384"></a><span class="lineno"> 1384</span><span class="comment">   * each of the #S_N_D_VALUE_SETS dynamic config slots.  Note we do *not*</span></div>
<div class="line"><a id="l01385" name="l01385"></a><span class="lineno"> 1385</span><span class="comment">   * assign a given slot&#39;s #m_d_value_sets pointer, unless at least one option has changed within the associated</span></div>
<div class="line"><a id="l01386" name="l01386"></a><span class="lineno"> 1386</span><span class="comment">   * canonical value set in #m_s_d_opt_sets.</span></div>
<div class="line"><a id="l01387" name="l01387"></a><span class="lineno"> 1387</span><span class="comment">   *</span></div>
<div class="line"><a id="l01388" name="l01388"></a><span class="lineno"> 1388</span><span class="comment">   * ### Rationale ###</span></div>
<div class="line"><a id="l01389" name="l01389"></a><span class="lineno"> 1389</span><span class="comment">   * A `list&lt;&gt;` is used here so that iterators to callbacks can be stored in `On_dynamic_change_func_handle`s without</span></div>
<div class="line"><a id="l01390" name="l01390"></a><span class="lineno"> 1390</span><span class="comment">   * the possibility of them being invalidated by insertions to or removals from the list (which would be the case if</span></div>
<div class="line"><a id="l01391" name="l01391"></a><span class="lineno"> 1391</span><span class="comment">   * `vector&lt;&gt;` were used).</span></div>
<div class="line"><a id="l01392" name="l01392"></a><span class="lineno"> 1392</span><span class="comment">   */</span></div>
<div class="line"><a id="l01393" name="l01393"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a08ba012812d46fcc6588d4bb8c4d04c9"> 1393</a></span>  boost::array&lt;std::list&lt;On_dynamic_change_func&gt;, <a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#ac26c2d6efe1670e940badccb3fdea609">S_N_D_VALUE_SETS</a>&gt; <a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#a08ba012812d46fcc6588d4bb8c4d04c9">m_on_dynamic_change_funcs</a>;</div>
<div class="line"><a id="l01394" name="l01394"></a><span class="lineno"> 1394</span><span class="comment"></span> </div>
<div class="line"><a id="l01395" name="l01395"></a><span class="lineno"> 1395</span><span class="comment">  /// Starts `false`; set to `true` permanently on successful apply_static_and_dynamic() or apply_dynamic().</span></div>
<div class="line"><a id="l01396" name="l01396"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#aa0e43bae09415b5a12a6b9e9f3e01756"> 1396</a></span><span class="comment"></span>  <span class="keywordtype">bool</span> <a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#aa0e43bae09415b5a12a6b9e9f3e01756">m_dynamic_values_set</a>;</div>
<div class="line"><a id="l01397" name="l01397"></a><span class="lineno"> 1397</span><span class="comment"></span> </div>
<div class="line"><a id="l01398" name="l01398"></a><span class="lineno"> 1398</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01399" name="l01399"></a><span class="lineno"> 1399</span><span class="comment">   * In short, truthy if and only if a `commit == false` update is currently in progress,</span></div>
<div class="line"><a id="l01400" name="l01400"></a><span class="lineno"> 1400</span><span class="comment">   * meaning there&#39;s an uncommitted *candidate* `Value_set` at the moment.  More precisely:</span></div>
<div class="line"><a id="l01401" name="l01401"></a><span class="lineno"> 1401</span><span class="comment">   *   - If the last-invoked `apply_*()` method (1) returned `false`, or (2) returned `true` but with arg</span></div>
<div class="line"><a id="l01402" name="l01402"></a><span class="lineno"> 1402</span><span class="comment">   *     `commit == true`, or (3) has never been called, or (4) was followed at any point</span></div>
<div class="line"><a id="l01403" name="l01403"></a><span class="lineno"> 1403</span><span class="comment">   *     by reject_candidates(), then this equals Update_type::S_NONE.  I.e., no multi-source update is</span></div>
<div class="line"><a id="l01404" name="l01404"></a><span class="lineno"> 1404</span><span class="comment">   *     currently in progress.  Otherwise:</span></div>
<div class="line"><a id="l01405" name="l01405"></a><span class="lineno"> 1405</span><span class="comment">   *   - This indicates which `apply_*(commit = true) == true` method (multi-source update type) it was.</span></div>
<div class="line"><a id="l01406" name="l01406"></a><span class="lineno"> 1406</span><span class="comment">   *     To the extent the exact type is irrelevant, its being not NONE indicates a multi-source update</span></div>
<div class="line"><a id="l01407" name="l01407"></a><span class="lineno"> 1407</span><span class="comment">   *     is in progress.</span></div>
<div class="line"><a id="l01408" name="l01408"></a><span class="lineno"> 1408</span><span class="comment">   *</span></div>
<div class="line"><a id="l01409" name="l01409"></a><span class="lineno"> 1409</span><span class="comment">   * Inside an `apply_*()` method, this is updated to its new value after parsing into #m_s_d_opt_sets.  Thus</span></div>
<div class="line"><a id="l01410" name="l01410"></a><span class="lineno"> 1410</span><span class="comment">   * during the bulk of such a method&#39;s processing we can easily determine whether this is step 1 of a</span></div>
<div class="line"><a id="l01411" name="l01411"></a><span class="lineno"> 1411</span><span class="comment">   * (potentially multi-source) update -- rather than step 2+ -- as this will equal NONE in the former</span></div>
<div class="line"><a id="l01412" name="l01412"></a><span class="lineno"> 1412</span><span class="comment">   * case only.</span></div>
<div class="line"><a id="l01413" name="l01413"></a><span class="lineno"> 1413</span><span class="comment">   *</span></div>
<div class="line"><a id="l01414" name="l01414"></a><span class="lineno"> 1414</span><span class="comment">   * When this is not-NONE, an `apply_*()` impl shall skip a couple of steps it would otherwise perform:</span></div>
<div class="line"><a id="l01415" name="l01415"></a><span class="lineno"> 1415</span><span class="comment">   *   - Individually-validating the default `Value_set()` values: Skip, as the first `apply_*()` in the sequence</span></div>
<div class="line"><a id="l01416" name="l01416"></a><span class="lineno"> 1416</span><span class="comment">   *     would have already done it.  So it&#39;s a waste of compute/entropy.</span></div>
<div class="line"><a id="l01417" name="l01417"></a><span class="lineno"> 1417</span><span class="comment">   *   - `apply_dynamic()` applying #m_d_baseline_value_sets onto to #m_s_d_opt_sets: Skip, as the first `apply_*()` in</span></div>
<div class="line"><a id="l01418" name="l01418"></a><span class="lineno"> 1418</span><span class="comment">   *     the sequence would have already done it.  So doing it again would be not only redundant but also destructive,</span></div>
<div class="line"><a id="l01419" name="l01419"></a><span class="lineno"> 1419</span><span class="comment">   *     overwriting any incremental changes made in preceding 1+ `apply_*()` calls.</span></div>
<div class="line"><a id="l01420" name="l01420"></a><span class="lineno"> 1420</span><span class="comment">   *</span></div>
<div class="line"><a id="l01421" name="l01421"></a><span class="lineno"> 1421</span><span class="comment">   * It would have been enough for it to be a `bool` for those tests.  It is an `enum` to be able to detect</span></div>
<div class="line"><a id="l01422" name="l01422"></a><span class="lineno"> 1422</span><span class="comment">   * calling `apply_X()` after `apply_Y(commit = false) == true` without reject_candidates() in-between.</span></div>
<div class="line"><a id="l01423" name="l01423"></a><span class="lineno"> 1423</span><span class="comment">   */</span></div>
<div class="line"><a id="l01424" name="l01424"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#ac74b46ed066f012a633ca16c400441ac"> 1424</a></span>  <a class="code hl_enumeration" href="classflow_1_1cfg_1_1Config__manager.html#aa0d03f4dcf7be2c21023c4073ac68b85">Update_type</a> <a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#ac74b46ed066f012a633ca16c400441ac">m_multi_src_update_in_progress</a>;</div>
<div class="line"><a id="l01425" name="l01425"></a><span class="lineno"> 1425</span>}; <span class="comment">// class Config_manager</span></div>
<div class="line"><a id="l01426" name="l01426"></a><span class="lineno"> 1426</span><span class="comment"></span> </div>
<div class="line"><a id="l01427" name="l01427"></a><span class="lineno"> 1427</span><span class="comment">/// Opaque handle for managing a dynamic config change callback.</span></div>
<div class="line"><a id="l01428" name="l01428"></a><span class="lineno"> 1428</span><span class="comment"></span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l01429" name="l01429"></a><span class="lineno"><a class="line" href="structflow_1_1cfg_1_1Config__manager_1_1On__dynamic__change__func__handle.html"> 1429</a></span><span class="keyword">struct </span><a class="code hl_class" href="classflow_1_1cfg_1_1Config__manager.html">Config_manager</a>&lt;S_d_value_set...&gt;::<a class="code hl_struct" href="structflow_1_1cfg_1_1Config__manager_1_1On__dynamic__change__func__handle.html">On_dynamic_change_func_handle</a></div>
<div class="line"><a id="l01430" name="l01430"></a><span class="lineno"> 1430</span>{<span class="comment"></span></div>
<div class="line"><a id="l01431" name="l01431"></a><span class="lineno"> 1431</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01432" name="l01432"></a><span class="lineno"> 1432</span><span class="comment">   * Opaque handle detail.</span></div>
<div class="line"><a id="l01433" name="l01433"></a><span class="lineno"> 1433</span><span class="comment">   * @internal</span></div>
<div class="line"><a id="l01434" name="l01434"></a><span class="lineno"> 1434</span><span class="comment">   * The dynamic config slot index for the value set which is associated with the callback.  This is used as an index</span></div>
<div class="line"><a id="l01435" name="l01435"></a><span class="lineno"> 1435</span><span class="comment">   * into `m_on_dynamic_change_funcs` to specify the list of callbacks which contains the callback.</span></div>
<div class="line"><a id="l01436" name="l01436"></a><span class="lineno"> 1436</span><span class="comment">   */</span></div>
<div class="line"><a id="l01437" name="l01437"></a><span class="lineno"><a class="line" href="structflow_1_1cfg_1_1Config__manager_1_1On__dynamic__change__func__handle.html#a555e60805c7ba2326892ef270171caa7"> 1437</a></span>  <span class="keywordtype">size_t</span> <a class="code hl_variable" href="structflow_1_1cfg_1_1Config__manager_1_1On__dynamic__change__func__handle.html#a555e60805c7ba2326892ef270171caa7">m_d_value_set_idx</a>;</div>
<div class="line"><a id="l01438" name="l01438"></a><span class="lineno"> 1438</span><span class="comment"></span> </div>
<div class="line"><a id="l01439" name="l01439"></a><span class="lineno"> 1439</span><span class="comment">  /**</span></div>
<div class="line"><a id="l01440" name="l01440"></a><span class="lineno"> 1440</span><span class="comment">   * Opaque handle detail.</span></div>
<div class="line"><a id="l01441" name="l01441"></a><span class="lineno"> 1441</span><span class="comment">   * @internal</span></div>
<div class="line"><a id="l01442" name="l01442"></a><span class="lineno"> 1442</span><span class="comment">   * Iterator to the callback within the associated callback list.</span></div>
<div class="line"><a id="l01443" name="l01443"></a><span class="lineno"> 1443</span><span class="comment">   */</span></div>
<div class="line"><a id="l01444" name="l01444"></a><span class="lineno"><a class="line" href="structflow_1_1cfg_1_1Config__manager_1_1On__dynamic__change__func__handle.html#a6d4eafd7d31261d7bdc8eb88a558fb2f"> 1444</a></span>  std::list&lt;On_dynamic_change_func&gt;::const_iterator <a class="code hl_variable" href="structflow_1_1cfg_1_1Config__manager_1_1On__dynamic__change__func__handle.html#a6d4eafd7d31261d7bdc8eb88a558fb2f">m_pos</a>;</div>
<div class="line"><a id="l01445" name="l01445"></a><span class="lineno"> 1445</span>};</div>
<div class="line"><a id="l01446" name="l01446"></a><span class="lineno"> 1446</span> </div>
<div class="line"><a id="l01447" name="l01447"></a><span class="lineno"> 1447</span><span class="comment">// Free functions: in *_fwd.hpp.</span></div>
<div class="line"><a id="l01448" name="l01448"></a><span class="lineno"> 1448</span> </div>
<div class="line"><a id="l01449" name="l01449"></a><span class="lineno"> 1449</span><span class="comment">// However the following refer to inner type(s) and hence must be declared here and not _fwd.hpp.</span></div>
<div class="line"><a id="l01450" name="l01450"></a><span class="lineno"> 1450</span><span class="comment"></span> </div>
<div class="line"><a id="l01451" name="l01451"></a><span class="lineno"> 1451</span><span class="comment">/**</span></div>
<div class="line"><a id="l01452" name="l01452"></a><span class="lineno"> 1452</span><span class="comment"> * Returns a value usable as `final_validator_func` arg to Config_manager::apply_static() and others -- for a</span></div>
<div class="line"><a id="l01453" name="l01453"></a><span class="lineno"> 1453</span><span class="comment"> * Null_value_set value set.</span></div>
<div class="line"><a id="l01454" name="l01454"></a><span class="lineno"> 1454</span><span class="comment"> *</span></div>
<div class="line"><a id="l01455" name="l01455"></a><span class="lineno"> 1455</span><span class="comment"> * @return See above.</span></div>
<div class="line"><a id="l01456" name="l01456"></a><span class="lineno"> 1456</span><span class="comment"> */</span></div>
<div class="line"><a id="l01457" name="l01457"></a><span class="lineno"> 1457</span><a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;Null_value_set&gt;::Type</a> <a class="code hl_function" href="namespaceflow_1_1cfg.html#af1a4e0a153ec8216ead76450e900e386">null_final_validator_func</a>();</div>
<div class="line"><a id="l01458" name="l01458"></a><span class="lineno"> 1458</span><span class="comment"></span> </div>
<div class="line"><a id="l01459" name="l01459"></a><span class="lineno"> 1459</span><span class="comment">/**</span></div>
<div class="line"><a id="l01460" name="l01460"></a><span class="lineno"> 1460</span><span class="comment"> * Returns a value usable as `declare_opts_func_moved` Config_manager ctor arg for a Null_value_set value set.</span></div>
<div class="line"><a id="l01461" name="l01461"></a><span class="lineno"> 1461</span><span class="comment"> * Naturally it does nothing.</span></div>
<div class="line"><a id="l01462" name="l01462"></a><span class="lineno"> 1462</span><span class="comment"> *</span></div>
<div class="line"><a id="l01463" name="l01463"></a><span class="lineno"> 1463</span><span class="comment"> * @return See above.</span></div>
<div class="line"><a id="l01464" name="l01464"></a><span class="lineno"> 1464</span><span class="comment"> */</span></div>
<div class="line"><a id="l01465" name="l01465"></a><span class="lineno"> 1465</span><a class="code hl_class" href="classflow_1_1Function.html">Option_set&lt;Null_value_set&gt;::Declare_options_func</a> <a class="code hl_function" href="namespaceflow_1_1cfg.html#adfe41c8484a878742976ddb84aa9e2d8">null_declare_opts_func</a>();</div>
<div class="line"><a id="l01466" name="l01466"></a><span class="lineno"> 1466</span> </div>
<div class="line"><a id="l01467" name="l01467"></a><span class="lineno"> 1467</span><span class="comment">// Template implementations.</span></div>
<div class="line"><a id="l01468" name="l01468"></a><span class="lineno"> 1468</span> </div>
<div class="line"><a id="l01469" name="l01469"></a><span class="lineno"> 1469</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l01470" name="l01470"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#ad59bfabf66e01922542629bae77508ad"> 1470</a></span><a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#ad59bfabf66e01922542629bae77508ad">Config_manager&lt;S_d_value_set...&gt;::Config_manager</a></div>
<div class="line"><a id="l01471" name="l01471"></a><span class="lineno"> 1471</span>  (<a class="code hl_class" href="classflow_1_1log_1_1Logger.html">log::Logger</a>* logger_ptr, <a class="code hl_typedef" href="namespaceflow_1_1util.html#ae4dc52186797094b3040379ff19124c9">util::String_view</a> nickname,</div>
<div class="line"><a id="l01472" name="l01472"></a><span class="lineno"> 1472</span>   <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Option_set&lt;S_d_value_set&gt;::Declare_options_func</a>&amp;&amp;... declare_opts_func_moved) :</div>
<div class="line"><a id="l01473" name="l01473"></a><span class="lineno"> 1473</span>  log::Log_context(logger_ptr, <a class="code hl_enumeration" href="namespaceflow.html#a3938730ab4b89daf13d027a5f620e7ce">Flow_log_component</a>::S_CFG),</div>
<div class="line"><a id="l01474" name="l01474"></a><span class="lineno"> 1474</span>  m_nickname(nickname),</div>
<div class="line"><a id="l01475" name="l01475"></a><span class="lineno"> 1475</span>  m_dynamic_values_set(false), <span class="comment">// Becomes `true` when apply*_dynamic() succeeds once.</span></div>
<div class="line"><a id="l01476" name="l01476"></a><span class="lineno"> 1476</span>  m_multi_src_update_in_progress(<a class="code hl_enumeration" href="classflow_1_1cfg_1_1Config__manager.html#aa0d03f4dcf7be2c21023c4073ac68b85">Update_type</a>::S_NONE)</div>
<div class="line"><a id="l01477" name="l01477"></a><span class="lineno"> 1477</span>{</div>
<div class="line"><a id="l01478" name="l01478"></a><span class="lineno"> 1478</span>  <span class="keyword">using </span><a class="code hl_function" href="namespaceflow_1_1util.html#a685b86585da2fa5186f51854e7ae1561">util::ostream_op_string</a>;</div>
<div class="line"><a id="l01479" name="l01479"></a><span class="lineno"> 1479</span> </div>
<div class="line"><a id="l01480" name="l01480"></a><span class="lineno"> 1480</span>  <span class="comment">/* @todo OK; this is really weird; I wanted to make this a static_assert() (and put it near where this constexpr</span></div>
<div class="line"><a id="l01481" name="l01481"></a><span class="lineno"> 1481</span><span class="comment">   * is initialized), but it is then triggered with gcc claiming Config_manager&lt;&gt; (with no tparams!) is</span></div>
<div class="line"><a id="l01482" name="l01482"></a><span class="lineno"> 1482</span><span class="comment">   * compiled -- bizarrely due to a simple FLOW_LOG_INFO() line a few hundred lines below this.  I find this</span></div>
<div class="line"><a id="l01483" name="l01483"></a><span class="lineno"> 1483</span><span class="comment">   * inexplicable; almost seems like a bug, but maybe not.  Look into it. -ygoldfel */</span></div>
<div class="line"><a id="l01484" name="l01484"></a><span class="lineno"> 1484</span>  assert((<a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#ad49d54a2ae34b14c276cf3de05c3c4f8">S_N_VALUE_SETS</a> != 0)</div>
<div class="line"><a id="l01485" name="l01485"></a><span class="lineno"> 1485</span>         &amp;&amp; <span class="stringliteral">&quot;Must have at least 2 template args to Config_manager; otherwise what are you configuring?&quot;</span>);</div>
<div class="line"><a id="l01486" name="l01486"></a><span class="lineno"> 1486</span> </div>
<div class="line"><a id="l01487" name="l01487"></a><span class="lineno"> 1487</span>  <span class="comment">// (See class doc header Implementation section for explanation of fold-expression (..., ) trick.)</span></div>
<div class="line"><a id="l01488" name="l01488"></a><span class="lineno"> 1488</span> </div>
<div class="line"><a id="l01489" name="l01489"></a><span class="lineno"> 1489</span>  <span class="comment">/* Set each m_s_d_opt_sets[] to store the Option_set&lt;S_d_value_set&gt;, for each S_d_value_set (class tparam-pack).</span></div>
<div class="line"><a id="l01490" name="l01490"></a><span class="lineno"> 1490</span><span class="comment">   * Recall that m_s_d_opt_sets[] stores them in order static, dynamic, static, dynamic, ....</span></div>
<div class="line"><a id="l01491" name="l01491"></a><span class="lineno"> 1491</span><span class="comment">   *</span></div>
<div class="line"><a id="l01492" name="l01492"></a><span class="lineno"> 1492</span><span class="comment">   * Set each m_d_baseline_value_sets[] to store a default-valued S_d_value_set (for dynamic sets only).</span></div>
<div class="line"><a id="l01493" name="l01493"></a><span class="lineno"> 1493</span><span class="comment">   * These may get overwritten optionally (because apply_static_and_dynamic() is optional) once, in</span></div>
<div class="line"><a id="l01494" name="l01494"></a><span class="lineno"> 1494</span><span class="comment">   * apply_static_and_dynamic().  For explanation what this is for see m_d_baseline_value_sets doc header.</span></div>
<div class="line"><a id="l01495" name="l01495"></a><span class="lineno"> 1495</span><span class="comment">   *</span></div>
<div class="line"><a id="l01496" name="l01496"></a><span class="lineno"> 1496</span><span class="comment">   * Initialize each m_d_value_sets[] as well. */</span></div>
<div class="line"><a id="l01497" name="l01497"></a><span class="lineno"> 1497</span>  <span class="keywordtype">bool</span> dyn_else_st = <span class="keyword">false</span>;</div>
<div class="line"><a id="l01498" name="l01498"></a><span class="lineno"> 1498</span>  <span class="keywordtype">size_t</span> value_set_idx = 0;</div>
<div class="line"><a id="l01499" name="l01499"></a><span class="lineno"> 1499</span>  <span class="keywordtype">size_t</span> d_value_set_idx = 0;</div>
<div class="line"><a id="l01500" name="l01500"></a><span class="lineno"> 1500</span>  (</div>
<div class="line"><a id="l01501" name="l01501"></a><span class="lineno"> 1501</span>    ...,</div>
<div class="line"><a id="l01502" name="l01502"></a><span class="lineno"> 1502</span>    (</div>
<div class="line"><a id="l01503" name="l01503"></a><span class="lineno"> 1503</span>      <span class="comment">// I (ygoldfel) tried make_shared() here, but it was too much for that gcc.  The perf impact is negligible anyway.</span></div>
<div class="line"><a id="l01504" name="l01504"></a><span class="lineno"> 1504</span>      <a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#a4e724d9d455ea31439c6832d0bc645bd">m_s_d_opt_sets</a>[value_set_idx]</div>
<div class="line"><a id="l01505" name="l01505"></a><span class="lineno"> 1505</span>        = <a class="code hl_typedef" href="classflow_1_1cfg_1_1Config__manager.html#a6f366f4070a90740e27d73029852e55f">Void_ptr</a></div>
<div class="line"><a id="l01506" name="l01506"></a><span class="lineno"> 1506</span>            (<span class="keyword">new</span> <a class="code hl_class" href="classflow_1_1cfg_1_1Option__set.html">Option_set&lt;S_d_value_set&gt;</a> <span class="comment">// &lt;-- Parameter pack expansion kernel here.</span></div>
<div class="line"><a id="l01507" name="l01507"></a><span class="lineno"> 1507</span>                   (<a class="code hl_function" href="classflow_1_1log_1_1Log__context.html#af4db395042b065b00398cd59845dcb4d">get_logger</a>(),</div>
<div class="line"><a id="l01508" name="l01508"></a><span class="lineno"> 1508</span>                    <a class="code hl_function" href="namespaceflow_1_1util.html#a685b86585da2fa5186f51854e7ae1561">ostream_op_string</a>(<a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#a68da387dad566805b969aded698661cb">m_nickname</a>, dyn_else_st ? <span class="stringliteral">&quot;/dynamic&quot;</span> : <span class="stringliteral">&quot;/static&quot;</span>,</div>
<div class="line"><a id="l01509" name="l01509"></a><span class="lineno"> 1509</span>                                      value_set_idx / 2), <span class="comment">// 0, 0, 1, 1, ....</span></div>
<div class="line"><a id="l01510" name="l01510"></a><span class="lineno"> 1510</span>                    std::move(declare_opts_func_moved))), <span class="comment">// (And here.)</span></div>
<div class="line"><a id="l01511" name="l01511"></a><span class="lineno"> 1511</span> </div>
<div class="line"><a id="l01512" name="l01512"></a><span class="lineno"> 1512</span>      <span class="comment">/* As noted above, fill a m_d_baseline_value_sets[] but for dynamic (non-null()) sets only.</span></div>
<div class="line"><a id="l01513" name="l01513"></a><span class="lineno"> 1513</span><span class="comment">       * Same deal for initializing m_d_value_sets.</span></div>
<div class="line"><a id="l01514" name="l01514"></a><span class="lineno"> 1514</span><span class="comment">       * (This is `if (dyn_else_st) { ... }` in expression form.) */</span></div>
<div class="line"><a id="l01515" name="l01515"></a><span class="lineno"> 1515</span>      dyn_else_st</div>
<div class="line"><a id="l01516" name="l01516"></a><span class="lineno"> 1516</span>        <span class="comment">// * (This is `if (!(...).null()) { ... }` in expression form.)</span></div>
<div class="line"><a id="l01517" name="l01517"></a><span class="lineno"> 1517</span>        &amp;&amp; (opt_set&lt;S_d_value_set&gt;(value_set_idx)-&gt;null() <span class="comment">// (And here.)</span></div>
<div class="line"><a id="l01518" name="l01518"></a><span class="lineno"> 1518</span>              || (<a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#a46a8745fe3fe54ede7f664b0a4cd8357">m_d_baseline_value_sets</a>[d_value_set_idx]</div>
<div class="line"><a id="l01519" name="l01519"></a><span class="lineno"> 1519</span>                    = <a class="code hl_typedef" href="classflow_1_1cfg_1_1Config__manager.html#a6f366f4070a90740e27d73029852e55f">Void_ptr</a>(<span class="keyword">new</span> S_d_value_set), <span class="comment">// (And here.)</span></div>
<div class="line"><a id="l01520" name="l01520"></a><span class="lineno"> 1520</span>                  <span class="keyword">true</span>),</div>
<div class="line"><a id="l01521" name="l01521"></a><span class="lineno"> 1521</span>            <a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#a447aa1d42bc9f40af92ce5968c0edc82">m_d_value_sets</a>[d_value_set_idx]</div>
<div class="line"><a id="l01522" name="l01522"></a><span class="lineno"> 1522</span>              = <a class="code hl_typedef" href="classflow_1_1cfg_1_1Config__manager.html#a6f366f4070a90740e27d73029852e55f">Void_ptr</a>(<span class="keyword">new</span> <span class="keyword">typename</span> S_d_value_set::Const_ptr), <span class="comment">// (And here.)</span></div>
<div class="line"><a id="l01523" name="l01523"></a><span class="lineno"> 1523</span>            ++d_value_set_idx,</div>
<div class="line"><a id="l01524" name="l01524"></a><span class="lineno"> 1524</span>            <span class="keyword">true</span>),</div>
<div class="line"><a id="l01525" name="l01525"></a><span class="lineno"> 1525</span> </div>
<div class="line"><a id="l01526" name="l01526"></a><span class="lineno"> 1526</span>      ++value_set_idx,</div>
<div class="line"><a id="l01527" name="l01527"></a><span class="lineno"> 1527</span>      dyn_else_st = !dyn_else_st</div>
<div class="line"><a id="l01528" name="l01528"></a><span class="lineno"> 1528</span>    )</div>
<div class="line"><a id="l01529" name="l01529"></a><span class="lineno"> 1529</span>  );</div>
<div class="line"><a id="l01530" name="l01530"></a><span class="lineno"> 1530</span> </div>
<div class="line"><a id="l01531" name="l01531"></a><span class="lineno"> 1531</span>  <a class="code hl_define" href="log_8hpp.html#affcf2e4c496ce3f42adf981669c623b8">FLOW_LOG_TRACE</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Ready; &quot;</span></div>
<div class="line"><a id="l01532" name="l01532"></a><span class="lineno"> 1532</span>                 <span class="stringliteral">&quot;managing [&quot;</span> &lt;&lt; <a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#a9c07f711e98435d00420277f1c20be75">S_N_S_VALUE_SETS</a> &lt;&lt; <span class="stringliteral">&quot;] dynamic+static option set pairs (some may be null/unused).&quot;</span>);</div>
<div class="line"><a id="l01533" name="l01533"></a><span class="lineno"> 1533</span>} <span class="comment">// Config_manager::Config_manager()</span></div>
<div class="line"><a id="l01534" name="l01534"></a><span class="lineno"> 1534</span> </div>
<div class="line"><a id="l01535" name="l01535"></a><span class="lineno"> 1535</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l01536" name="l01536"></a><span class="lineno"> 1536</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l01537" name="l01537"></a><span class="lineno"> 1537</span><a class="code hl_class" href="classflow_1_1cfg_1_1Option__set.html">Option_set&lt;Value_set&gt;</a>*</div>
<div class="line"><a id="l01538" name="l01538"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a318e125f78cb7e471cae35e2651ab01f"> 1538</a></span>  <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a318e125f78cb7e471cae35e2651ab01f">Config_manager&lt;S_d_value_set...&gt;::opt_set</a>(<span class="keywordtype">size_t</span> value_set_idx)</div>
<div class="line"><a id="l01539" name="l01539"></a><span class="lineno"> 1539</span>{</div>
<div class="line"><a id="l01540" name="l01540"></a><span class="lineno"> 1540</span>  <span class="comment">// Fish out the value stuffed into the ptr&lt;void&gt; at the given slot by the ctor.</span></div>
<div class="line"><a id="l01541" name="l01541"></a><span class="lineno"> 1541</span> </div>
<div class="line"><a id="l01542" name="l01542"></a><span class="lineno"> 1542</span>  assert(value_set_idx &lt; S_N_VALUE_SETS);</div>
<div class="line"><a id="l01543" name="l01543"></a><span class="lineno"> 1543</span>  <span class="keywordflow">return</span> <span class="keyword">static_cast&lt;</span><a class="code hl_class" href="classflow_1_1cfg_1_1Option__set.html">Option_set&lt;Value_set&gt;</a>*<span class="keyword">&gt;</span> <span class="comment">// Attn: void* -&gt; T* cast; no RTTI to check our type safety.</span></div>
<div class="line"><a id="l01544" name="l01544"></a><span class="lineno"> 1544</span>           (m_s_d_opt_sets[value_set_idx].get());</div>
<div class="line"><a id="l01545" name="l01545"></a><span class="lineno"> 1545</span>}</div>
<div class="line"><a id="l01546" name="l01546"></a><span class="lineno"> 1546</span> </div>
<div class="line"><a id="l01547" name="l01547"></a><span class="lineno"> 1547</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l01548" name="l01548"></a><span class="lineno"> 1548</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l01549" name="l01549"></a><span class="lineno"> 1549</span>Value_set*</div>
<div class="line"><a id="l01550" name="l01550"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#abe40d6451276e0d4c7c0867669791f9c"> 1550</a></span>  <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#abe40d6451276e0d4c7c0867669791f9c">Config_manager&lt;S_d_value_set...&gt;::d_baseline_value_set</a>(<span class="keywordtype">size_t</span> d_value_set_idx)</div>
<div class="line"><a id="l01551" name="l01551"></a><span class="lineno"> 1551</span>{</div>
<div class="line"><a id="l01552" name="l01552"></a><span class="lineno"> 1552</span>  <span class="comment">// Fish out the value stuffed into the ptr&lt;void&gt; at the given slot by the ctor.</span></div>
<div class="line"><a id="l01553" name="l01553"></a><span class="lineno"> 1553</span> </div>
<div class="line"><a id="l01554" name="l01554"></a><span class="lineno"> 1554</span>  assert(d_value_set_idx &lt; S_N_D_VALUE_SETS);</div>
<div class="line"><a id="l01555" name="l01555"></a><span class="lineno"> 1555</span>  <span class="keywordflow">return</span> <span class="keyword">static_cast&lt;</span>Value_set*<span class="keyword">&gt;</span> <span class="comment">// Attn: void* -&gt; T* cast; no RTTI to check our type safety.</span></div>
<div class="line"><a id="l01556" name="l01556"></a><span class="lineno"> 1556</span>           (m_d_baseline_value_sets[d_value_set_idx].get());</div>
<div class="line"><a id="l01557" name="l01557"></a><span class="lineno"> 1557</span>}</div>
<div class="line"><a id="l01558" name="l01558"></a><span class="lineno"> 1558</span> </div>
<div class="line"><a id="l01559" name="l01559"></a><span class="lineno"> 1559</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l01560" name="l01560"></a><span class="lineno"> 1560</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l01561" name="l01561"></a><span class="lineno"> 1561</span><span class="keyword">const</span> <a class="code hl_class" href="classflow_1_1cfg_1_1Option__set.html">Option_set&lt;Value_set&gt;</a>*</div>
<div class="line"><a id="l01562" name="l01562"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#af54e2f1360834ece6fd06d34b387978c"> 1562</a></span>  <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a318e125f78cb7e471cae35e2651ab01f">Config_manager&lt;S_d_value_set...&gt;::opt_set</a>(<span class="keywordtype">size_t</span> value_set_idx)<span class="keyword"> const</span></div>
<div class="line"><a id="l01563" name="l01563"></a><span class="lineno"> 1563</span><span class="keyword"></span>{</div>
<div class="line"><a id="l01564" name="l01564"></a><span class="lineno"> 1564</span>  <span class="keywordflow">return</span> <span class="keyword">const_cast&lt;</span><a class="code hl_class" href="classflow_1_1cfg_1_1Config__manager.html">Config_manager</a>&lt;S_d_value_set...<span class="keyword">&gt;</span>*&gt;(<span class="keyword">this</span>)-&gt;opt_set&lt;Value_set&gt;(value_set_idx);</div>
<div class="line"><a id="l01565" name="l01565"></a><span class="lineno"> 1565</span>}</div>
<div class="line"><a id="l01566" name="l01566"></a><span class="lineno"> 1566</span> </div>
<div class="line"><a id="l01567" name="l01567"></a><span class="lineno"> 1567</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l01568" name="l01568"></a><span class="lineno"> 1568</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l01569" name="l01569"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a2c9f7e2dd8973d5ff191eee1c2394cae"> 1569</a></span><span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a2c9f7e2dd8973d5ff191eee1c2394cae">Config_manager&lt;S_d_value_set...&gt;::option_set_canonicalize_or_reject</a></div>
<div class="line"><a id="l01570" name="l01570"></a><span class="lineno"> 1570</span>       (<a class="code hl_class" href="classflow_1_1cfg_1_1Option__set.html">Option_set&lt;Value_set&gt;</a>* opt_set, <span class="keywordtype">bool</span> canonicalize_else_reject, <span class="keywordtype">bool</span>* changed_or_null)</div>
<div class="line"><a id="l01571" name="l01571"></a><span class="lineno"> 1571</span>{</div>
<div class="line"><a id="l01572" name="l01572"></a><span class="lineno"> 1572</span>  <span class="keywordflow">if</span> (opt_set-&gt;<a class="code hl_function" href="classflow_1_1cfg_1_1Option__set.html#accd086867406387070ac766b03e7998c">null</a>())</div>
<div class="line"><a id="l01573" name="l01573"></a><span class="lineno"> 1573</span>  {</div>
<div class="line"><a id="l01574" name="l01574"></a><span class="lineno"> 1574</span>    <span class="comment">// If null() then *opt_set wasn&#39;t even parse*()d (see apply_impl()), so certainly it hasn&#39;t changed.</span></div>
<div class="line"><a id="l01575" name="l01575"></a><span class="lineno"> 1575</span>    changed_or_null</div>
<div class="line"><a id="l01576" name="l01576"></a><span class="lineno"> 1576</span>      &amp;&amp; (*changed_or_null = <span class="keyword">false</span>);</div>
<div class="line"><a id="l01577" name="l01577"></a><span class="lineno"> 1577</span>  }</div>
<div class="line"><a id="l01578" name="l01578"></a><span class="lineno"> 1578</span>  <span class="keywordflow">else</span></div>
<div class="line"><a id="l01579" name="l01579"></a><span class="lineno"> 1579</span>  {</div>
<div class="line"><a id="l01580" name="l01580"></a><span class="lineno"> 1580</span>    canonicalize_else_reject ? opt_set-&gt;<a class="code hl_function" href="classflow_1_1cfg_1_1Option__set.html#aa1f780bfd3a5ff07ade1e36785e28f49">canonicalize_candidate</a>(changed_or_null)</div>
<div class="line"><a id="l01581" name="l01581"></a><span class="lineno"> 1581</span>                             : opt_set-&gt;<a class="code hl_function" href="classflow_1_1cfg_1_1Option__set.html#ac5452a6e866c911df46d948f02b6a587">reject_candidate</a>();</div>
<div class="line"><a id="l01582" name="l01582"></a><span class="lineno"> 1582</span>  }</div>
<div class="line"><a id="l01583" name="l01583"></a><span class="lineno"> 1583</span>}</div>
<div class="line"><a id="l01584" name="l01584"></a><span class="lineno"> 1584</span> </div>
<div class="line"><a id="l01585" name="l01585"></a><span class="lineno"> 1585</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l01586" name="l01586"></a><span class="lineno"> 1586</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l01587" name="l01587"></a><span class="lineno"> 1587</span><span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1cfg_1_1Config__manager.html">Config_manager</a>&lt;S_d_value_set...&gt;::On_dynamic_change_func_handle</div>
<div class="line"><a id="l01588" name="l01588"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a978295c03998af212b464061d780520b"> 1588</a></span>  <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a978295c03998af212b464061d780520b">Config_manager&lt;S_d_value_set...&gt;::register_dynamic_change_listener</a></div>
<div class="line"><a id="l01589" name="l01589"></a><span class="lineno"> 1589</span>    (<span class="keywordtype">size_t</span> d_value_set_idx, <a class="code hl_class" href="classflow_1_1Function.html">On_dynamic_change_func</a>&amp;&amp; on_dynamic_change_func_moved)</div>
<div class="line"><a id="l01590" name="l01590"></a><span class="lineno"> 1590</span>{</div>
<div class="line"><a id="l01591" name="l01591"></a><span class="lineno"> 1591</span>  <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Adding dynamic-change listener for dynamic value set &quot;</span></div>
<div class="line"><a id="l01592" name="l01592"></a><span class="lineno"> 1592</span>                <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; d_value_set_idx &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l01593" name="l01593"></a><span class="lineno"> 1593</span> </div>
<div class="line"><a id="l01594" name="l01594"></a><span class="lineno"> 1594</span>  assert((d_value_set_idx &lt; S_N_D_VALUE_SETS) &amp;&amp; <span class="stringliteral">&quot;Invalid dynamic option set index.&quot;</span>);</div>
<div class="line"><a id="l01595" name="l01595"></a><span class="lineno"> 1595</span>  assert((!opt_set&lt;Value_set&gt;((d_value_set_idx * 2) + 1)-&gt;null())</div>
<div class="line"><a id="l01596" name="l01596"></a><span class="lineno"> 1596</span>         &amp;&amp; <span class="stringliteral">&quot;Do not register dynamic change listener for Null_value_set or otherwise null value set.&quot;</span>);</div>
<div class="line"><a id="l01597" name="l01597"></a><span class="lineno"> 1597</span> </div>
<div class="line"><a id="l01598" name="l01598"></a><span class="lineno"> 1598</span>  <span class="comment">// Not thread-safe (as advertised) against apply*_dynamic() or unregister_dynamic_change_listener().</span></div>
<div class="line"><a id="l01599" name="l01599"></a><span class="lineno"> 1599</span>  m_on_dynamic_change_funcs[d_value_set_idx].emplace_back(std::move(on_dynamic_change_func_moved));</div>
<div class="line"><a id="l01600" name="l01600"></a><span class="lineno"> 1600</span>  <span class="keyword">const</span> <span class="keyword">auto</span>&amp; callback_pos = std::prev(m_on_dynamic_change_funcs[d_value_set_idx].end());</div>
<div class="line"><a id="l01601" name="l01601"></a><span class="lineno"> 1601</span> </div>
<div class="line"><a id="l01602" name="l01602"></a><span class="lineno"> 1602</span>  <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Added dynamic-change listener [@&quot;</span> &lt;&lt; &amp;(*callback_pos) &lt;&lt;</div>
<div class="line"><a id="l01603" name="l01603"></a><span class="lineno"> 1603</span>                <span class="stringliteral">&quot;] for dynamic value set [&quot;</span> &lt;&lt; d_value_set_idx &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l01604" name="l01604"></a><span class="lineno"> 1604</span> </div>
<div class="line"><a id="l01605" name="l01605"></a><span class="lineno"> 1605</span>  <span class="keywordflow">return</span> <a class="code hl_struct" href="structflow_1_1cfg_1_1Config__manager_1_1On__dynamic__change__func__handle.html">On_dynamic_change_func_handle</a>{ d_value_set_idx, callback_pos };</div>
<div class="line"><a id="l01606" name="l01606"></a><span class="lineno"> 1606</span>}</div>
<div class="line"><a id="l01607" name="l01607"></a><span class="lineno"> 1607</span> </div>
<div class="line"><a id="l01608" name="l01608"></a><span class="lineno"> 1608</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l01609" name="l01609"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a4e0dfe1e8f57d974a775f1320bd9856d"> 1609</a></span><span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a4e0dfe1e8f57d974a775f1320bd9856d">Config_manager&lt;S_d_value_set...&gt;::unregister_dynamic_change_listener</a> (<span class="keyword">const</span> <a class="code hl_struct" href="structflow_1_1cfg_1_1Config__manager_1_1On__dynamic__change__func__handle.html">On_dynamic_change_func_handle</a>&amp; handle)</div>
<div class="line"><a id="l01610" name="l01610"></a><span class="lineno"> 1610</span>{</div>
<div class="line"><a id="l01611" name="l01611"></a><span class="lineno"> 1611</span>  <span class="comment">// Not thread-safe (as advertised) against apply*_dynamic() or register_dynamic_change_listener().</span></div>
<div class="line"><a id="l01612" name="l01612"></a><span class="lineno"> 1612</span> </div>
<div class="line"><a id="l01613" name="l01613"></a><span class="lineno"> 1613</span>  <span class="keyword">auto</span>&amp; on_dynamic_change_funcs = m_on_dynamic_change_funcs[handle.<a class="code hl_variable" href="structflow_1_1cfg_1_1Config__manager_1_1On__dynamic__change__func__handle.html#a555e60805c7ba2326892ef270171caa7">m_d_value_set_idx</a>];</div>
<div class="line"><a id="l01614" name="l01614"></a><span class="lineno"> 1614</span>  on_dynamic_change_funcs.erase(handle.<a class="code hl_variable" href="structflow_1_1cfg_1_1Config__manager_1_1On__dynamic__change__func__handle.html#a6d4eafd7d31261d7bdc8eb88a558fb2f">m_pos</a>);</div>
<div class="line"><a id="l01615" name="l01615"></a><span class="lineno"> 1615</span> </div>
<div class="line"><a id="l01616" name="l01616"></a><span class="lineno"> 1616</span>  <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Removed dynamic-change listener [@&quot;</span> &lt;&lt; &amp;(*handle.<a class="code hl_variable" href="structflow_1_1cfg_1_1Config__manager_1_1On__dynamic__change__func__handle.html#a6d4eafd7d31261d7bdc8eb88a558fb2f">m_pos</a>) &lt;&lt;</div>
<div class="line"><a id="l01617" name="l01617"></a><span class="lineno"> 1617</span>                <span class="stringliteral">&quot;] for dynamic value set [&quot;</span> &lt;&lt; handle.<a class="code hl_variable" href="structflow_1_1cfg_1_1Config__manager_1_1On__dynamic__change__func__handle.html#a555e60805c7ba2326892ef270171caa7">m_d_value_set_idx</a> &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l01618" name="l01618"></a><span class="lineno"> 1618</span>}</div>
<div class="line"><a id="l01619" name="l01619"></a><span class="lineno"> 1619</span> </div>
<div class="line"><a id="l01620" name="l01620"></a><span class="lineno"> 1620</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l01621" name="l01621"></a><span class="lineno"> 1621</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l01622" name="l01622"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a22bfec8082d0c7b5dff9ee7e98865707"> 1622</a></span><span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a22bfec8082d0c7b5dff9ee7e98865707">Config_manager&lt;S_d_value_set...&gt;::apply_static</a></div>
<div class="line"><a id="l01623" name="l01623"></a><span class="lineno"> 1623</span>       (<span class="keyword">const</span> fs::path&amp; static_cfg_path,</div>
<div class="line"><a id="l01624" name="l01624"></a><span class="lineno"> 1624</span>        <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;Value_set&gt;::Type</a>&amp;... final_validator_func,</div>
<div class="line"><a id="l01625" name="l01625"></a><span class="lineno"> 1625</span>        <span class="keywordtype">bool</span> commit)</div>
<div class="line"><a id="l01626" name="l01626"></a><span class="lineno"> 1626</span>{</div>
<div class="line"><a id="l01627" name="l01627"></a><span class="lineno"> 1627</span>  <span class="keywordflow">return</span> apply_static_impl&lt;Value_set...&gt;(<span class="keyword">false</span>, static_cfg_path, final_validator_func..., commit);</div>
<div class="line"><a id="l01628" name="l01628"></a><span class="lineno"> 1628</span>}</div>
<div class="line"><a id="l01629" name="l01629"></a><span class="lineno"> 1629</span> </div>
<div class="line"><a id="l01630" name="l01630"></a><span class="lineno"> 1630</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l01631" name="l01631"></a><span class="lineno"> 1631</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l01632" name="l01632"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#af027c6f4b595f1f8ebbd6d41ad705f5e"> 1632</a></span><span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a22bfec8082d0c7b5dff9ee7e98865707">Config_manager&lt;S_d_value_set...&gt;::apply_static</a></div>
<div class="line"><a id="l01633" name="l01633"></a><span class="lineno"> 1633</span>       (<a class="code hl_enumeration" href="classflow_1_1cfg_1_1Config__manager.html#a6768eb0c92bd11fd84986058903b10d4">allow_invalid_defaults_tag_t</a>,</div>
<div class="line"><a id="l01634" name="l01634"></a><span class="lineno"> 1634</span>        <span class="keyword">const</span> fs::path&amp; static_cfg_path,</div>
<div class="line"><a id="l01635" name="l01635"></a><span class="lineno"> 1635</span>        <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;Value_set&gt;::Type</a>&amp;... final_validator_func,</div>
<div class="line"><a id="l01636" name="l01636"></a><span class="lineno"> 1636</span>        <span class="keywordtype">bool</span> commit)</div>
<div class="line"><a id="l01637" name="l01637"></a><span class="lineno"> 1637</span>{</div>
<div class="line"><a id="l01638" name="l01638"></a><span class="lineno"> 1638</span>  <span class="keywordflow">return</span> apply_static_impl&lt;Value_set...&gt;(<span class="keyword">true</span>, static_cfg_path, final_validator_func..., commit);</div>
<div class="line"><a id="l01639" name="l01639"></a><span class="lineno"> 1639</span>}</div>
<div class="line"><a id="l01640" name="l01640"></a><span class="lineno"> 1640</span> </div>
<div class="line"><a id="l01641" name="l01641"></a><span class="lineno"> 1641</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l01642" name="l01642"></a><span class="lineno"> 1642</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l01643" name="l01643"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#ad320a74f83474c93cce385b0b9da887e"> 1643</a></span><span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#ad320a74f83474c93cce385b0b9da887e">Config_manager&lt;S_d_value_set...&gt;::apply_static_impl</a></div>
<div class="line"><a id="l01644" name="l01644"></a><span class="lineno"> 1644</span>       (<span class="keywordtype">bool</span> allow_invalid_defaults,</div>
<div class="line"><a id="l01645" name="l01645"></a><span class="lineno"> 1645</span>        <span class="keyword">const</span> fs::path&amp; static_cfg_path,</div>
<div class="line"><a id="l01646" name="l01646"></a><span class="lineno"> 1646</span>        <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;Value_set&gt;::Type</a>&amp;... final_validator_func,</div>
<div class="line"><a id="l01647" name="l01647"></a><span class="lineno"> 1647</span>        <span class="keywordtype">bool</span> commit)</div>
<div class="line"><a id="l01648" name="l01648"></a><span class="lineno"> 1648</span>{</div>
<div class="line"><a id="l01649" name="l01649"></a><span class="lineno"> 1649</span>  <span class="keyword">using </span>boost::unordered_set;</div>
<div class="line"><a id="l01650" name="l01650"></a><span class="lineno"> 1650</span>  <span class="keyword">using </span>std::string;</div>
<div class="line"><a id="l01651" name="l01651"></a><span class="lineno"> 1651</span>  <span class="keyword">using </span>std::declval;</div>
<div class="line"><a id="l01652" name="l01652"></a><span class="lineno"> 1652</span>  <span class="keyword">using </span>std::is_same_v;</div>
<div class="line"><a id="l01653" name="l01653"></a><span class="lineno"> 1653</span> </div>
<div class="line"><a id="l01654" name="l01654"></a><span class="lineno"> 1654</span>  <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Request to apply static config file [&quot;</span> &lt;&lt; static_cfg_path &lt;&lt; <span class="stringliteral">&quot;].  &quot;</span></div>
<div class="line"><a id="l01655" name="l01655"></a><span class="lineno"> 1655</span>                <span class="stringliteral">&quot;Invalid defaults allowed if explicitly set in file? = [&quot;</span> &lt;&lt; allow_invalid_defaults &lt;&lt; <span class="stringliteral">&quot;].  &quot;</span></div>
<div class="line"><a id="l01656" name="l01656"></a><span class="lineno"> 1656</span>                <span class="stringliteral">&quot;This application (if successful) shall end with canonicalizing values? = [&quot;</span> &lt;&lt; commit &lt;&lt; <span class="stringliteral">&quot;]; &quot;</span></div>
<div class="line"><a id="l01657" name="l01657"></a><span class="lineno"> 1657</span>                <span class="stringliteral">&quot;multi-source update already in progress (0=none) = [&quot;</span> &lt;&lt; <span class="keywordtype">int</span>(m_multi_src_update_in_progress) &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l01658" name="l01658"></a><span class="lineno"> 1658</span> </div>
<div class="line"><a id="l01659" name="l01659"></a><span class="lineno"> 1659</span>  reject_candidates_if_update_type_changed(Update_type::S_STATIC);</div>
<div class="line"><a id="l01660" name="l01660"></a><span class="lineno"> 1660</span> </div>
<div class="line"><a id="l01661" name="l01661"></a><span class="lineno"> 1661</span>  <span class="comment">/* Even if they&#39;re all .null(), they must give some validator functions (they&#39;ll be ignored and should just</span></div>
<div class="line"><a id="l01662" name="l01662"></a><span class="lineno"> 1662</span><span class="comment">   * be assigned null_final_validator_func() a/k/a Final_validator_func&lt;Null_value_set&gt;::null() anyway,</span></div>
<div class="line"><a id="l01663" name="l01663"></a><span class="lineno"> 1663</span><span class="comment">   * though we don&#39;t enforce it). */</span></div>
<div class="line"><a id="l01664" name="l01664"></a><span class="lineno"> 1664</span>  <span class="keyword">static_assert</span>(<span class="keyword">sizeof</span>...(Value_set) == S_N_S_VALUE_SETS,</div>
<div class="line"><a id="l01665" name="l01665"></a><span class="lineno"> 1665</span>                <span class="stringliteral">&quot;You must supply N/2 `final_validator_func`s, where N is # of S_d_value_set params.  &quot;</span></div>
<div class="line"><a id="l01666" name="l01666"></a><span class="lineno"> 1666</span>                  <span class="stringliteral">&quot;Use null_final_validator_func() for any Null_value_set.&quot;</span>);</div>
<div class="line"><a id="l01667" name="l01667"></a><span class="lineno"> 1667</span> </div>
<div class="line"><a id="l01668" name="l01668"></a><span class="lineno"> 1668</span>  <span class="comment">/* (See class doc header Implementation section for explanation of fold-expression (..., ) trick.)</span></div>
<div class="line"><a id="l01669" name="l01669"></a><span class="lineno"> 1669</span><span class="comment">   *</span></div>
<div class="line"><a id="l01670" name="l01670"></a><span class="lineno"> 1670</span><span class="comment">   * Note, though, that (... &amp;&amp; expr) (of, say, length 4) evaluates to (((expr1 &amp;&amp; expr2) &amp;&amp; expr3) &amp;&amp; expr4);</span></div>
<div class="line"><a id="l01671" name="l01671"></a><span class="lineno"> 1671</span><span class="comment">   * which means it&#39;ll run through the `expr...i...`s until one evaluates to false; then it stops and evaluates</span></div>
<div class="line"><a id="l01672" name="l01672"></a><span class="lineno"> 1672</span><span class="comment">   * no more past that. */</span></div>
<div class="line"><a id="l01673" name="l01673"></a><span class="lineno"> 1673</span> </div>
<div class="line"><a id="l01674" name="l01674"></a><span class="lineno"> 1674</span>  <span class="keywordtype">size_t</span> value_set_idx;</div>
<div class="line"><a id="l01675" name="l01675"></a><span class="lineno"> 1675</span>  <span class="keywordtype">bool</span> success = <span class="keyword">true</span>;</div>
<div class="line"><a id="l01676" name="l01676"></a><span class="lineno"> 1676</span> </div>
<div class="line"><a id="l01677" name="l01677"></a><span class="lineno"> 1677</span>  <span class="comment">/* Optionally scan the defaults themselves for individual-option-validator validity if so requested.</span></div>
<div class="line"><a id="l01678" name="l01678"></a><span class="lineno"> 1678</span><span class="comment">   * However no need to repeat this, if a multi-source update was already in progress. */</span></div>
<div class="line"><a id="l01679" name="l01679"></a><span class="lineno"> 1679</span>  <span class="keywordflow">if</span> ((!allow_invalid_defaults) &amp;&amp; (m_multi_src_update_in_progress == Update_type::S_NONE))</div>
<div class="line"><a id="l01680" name="l01680"></a><span class="lineno"> 1680</span>  {</div>
<div class="line"><a id="l01681" name="l01681"></a><span class="lineno"> 1681</span>    value_set_idx = 0;</div>
<div class="line"><a id="l01682" name="l01682"></a><span class="lineno"> 1682</span>    [[maybe_unused]] <span class="keyword">const</span> <span class="keyword">auto</span> dummy = <span class="comment">// Defeats false gcc warning due to trailing `success` when N_S_VALUE_SETS is 1.</span></div>
<div class="line"><a id="l01683" name="l01683"></a><span class="lineno"> 1683</span>    (</div>
<div class="line"><a id="l01684" name="l01684"></a><span class="lineno"> 1684</span>      ...</div>
<div class="line"><a id="l01685" name="l01685"></a><span class="lineno"> 1685</span>      &amp;&amp;</div>
<div class="line"><a id="l01686" name="l01686"></a><span class="lineno"> 1686</span>      (</div>
<div class="line"><a id="l01687" name="l01687"></a><span class="lineno"> 1687</span>        opt_set&lt;Value_set&gt;(value_set_idx) <span class="comment">// Param pack expansion kernel here.</span></div>
<div class="line"><a id="l01688" name="l01688"></a><span class="lineno"> 1688</span>          -&gt;validate_values(&amp;success), <span class="comment">// Set `success`...</span></div>
<div class="line"><a id="l01689" name="l01689"></a><span class="lineno"> 1689</span>        value_set_idx += 2, <span class="comment">// (Skip dynamic ones.)</span></div>
<div class="line"><a id="l01690" name="l01690"></a><span class="lineno"> 1690</span>        success <span class="comment">// ...and if it&#39;s false, the subsequent option sets shall be skipped.</span></div>
<div class="line"><a id="l01691" name="l01691"></a><span class="lineno"> 1691</span>      )</div>
<div class="line"><a id="l01692" name="l01692"></a><span class="lineno"> 1692</span>    );</div>
<div class="line"><a id="l01693" name="l01693"></a><span class="lineno"> 1693</span> </div>
<div class="line"><a id="l01694" name="l01694"></a><span class="lineno"> 1694</span>    <span class="keywordflow">if</span> (!success) <span class="comment">// It would have logged the exact problem, but we still want to clearly say what happened, high-level:</span></div>
<div class="line"><a id="l01695" name="l01695"></a><span class="lineno"> 1695</span>    {</div>
<div class="line"><a id="l01696" name="l01696"></a><span class="lineno"> 1696</span>      <a class="code hl_define" href="log_8hpp.html#a626c7dc4d3b4dc0b32a8aac8624d66bc">FLOW_LOG_WARNING</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: &quot;</span></div>
<div class="line"><a id="l01697" name="l01697"></a><span class="lineno"> 1697</span>                       <span class="stringliteral">&quot;Request to apply static config file [&quot;</span> &lt;&lt; static_cfg_path &lt;&lt; <span class="stringliteral">&quot;]:  &quot;</span></div>
<div class="line"><a id="l01698" name="l01698"></a><span class="lineno"> 1698</span>                       <span class="stringliteral">&quot;Will not parse file, because stringent check &quot;</span></div>
<div class="line"><a id="l01699" name="l01699"></a><span class="lineno"> 1699</span>                       <span class="stringliteral">&quot;of defaults detected at least 1 individually-invalid default value.  Either correct &quot;</span></div>
<div class="line"><a id="l01700" name="l01700"></a><span class="lineno"> 1700</span>                       <span class="stringliteral">&quot;the default or use apply_static(allow_invalid_defaults_tag_t) overload.&quot;</span>);</div>
<div class="line"><a id="l01701" name="l01701"></a><span class="lineno"> 1701</span>    }</div>
<div class="line"><a id="l01702" name="l01702"></a><span class="lineno"> 1702</span>  } <span class="comment">// if (!allow_invalid_defaults)</span></div>
<div class="line"><a id="l01703" name="l01703"></a><span class="lineno"> 1703</span> </div>
<div class="line"><a id="l01704" name="l01704"></a><span class="lineno"> 1704</span>  <span class="comment">// First collect all valid static option names as required by apply_static_or_dynamic_impl().</span></div>
<div class="line"><a id="l01705" name="l01705"></a><span class="lineno"> 1705</span>  unordered_set&lt;string&gt; all_opt_names; <span class="comment">// The result.</span></div>
<div class="line"><a id="l01706" name="l01706"></a><span class="lineno"> 1706</span>  unordered_set&lt;string&gt; <span class="keyword">const</span> * this_opt_names; <span class="comment">// Used for each static slot.</span></div>
<div class="line"><a id="l01707" name="l01707"></a><span class="lineno"> 1707</span>  <span class="comment">// Ensure Option_set&lt;&gt;::option_names() returns ref-to-const, so this_opt_names can safely point to it.</span></div>
<div class="line"><a id="l01708" name="l01708"></a><span class="lineno"> 1708</span>  <span class="keyword">static_assert</span>(is_same_v&lt;<span class="keyword">decltype</span>(declval&lt;Option_set&lt;Null_value_set&gt;&gt;().option_names()),</div>
<div class="line"><a id="l01709" name="l01709"></a><span class="lineno"> 1709</span>                          <span class="keyword">decltype</span>(*this_opt_names)&gt;,</div>
<div class="line"><a id="l01710" name="l01710"></a><span class="lineno"> 1710</span>                <span class="stringliteral">&quot;Option_set&lt;&gt;::option_names() must return ref-to-const.  Bug?&quot;</span>);</div>
<div class="line"><a id="l01711" name="l01711"></a><span class="lineno"> 1711</span>  value_set_idx = 0;</div>
<div class="line"><a id="l01712" name="l01712"></a><span class="lineno"> 1712</span>  <span class="keywordflow">if</span> (success) <span class="comment">// Skip all this if failed above.</span></div>
<div class="line"><a id="l01713" name="l01713"></a><span class="lineno"> 1713</span>  {</div>
<div class="line"><a id="l01714" name="l01714"></a><span class="lineno"> 1714</span>    (</div>
<div class="line"><a id="l01715" name="l01715"></a><span class="lineno"> 1715</span>      ...,</div>
<div class="line"><a id="l01716" name="l01716"></a><span class="lineno"> 1716</span>      (</div>
<div class="line"><a id="l01717" name="l01717"></a><span class="lineno"> 1717</span>        this_opt_names = &amp;(opt_set&lt;Value_set&gt; <span class="comment">// Param pack expansion kernel here.</span></div>
<div class="line"><a id="l01718" name="l01718"></a><span class="lineno"> 1718</span>                             (value_set_idx)-&gt;option_names()),</div>
<div class="line"><a id="l01719" name="l01719"></a><span class="lineno"> 1719</span>        all_opt_names.insert(this_opt_names-&gt;begin(), this_opt_names-&gt;end()),</div>
<div class="line"><a id="l01720" name="l01720"></a><span class="lineno"> 1720</span>        value_set_idx += 2 <span class="comment">// Skip dynamic ones.</span></div>
<div class="line"><a id="l01721" name="l01721"></a><span class="lineno"> 1721</span>      )</div>
<div class="line"><a id="l01722" name="l01722"></a><span class="lineno"> 1722</span>    );</div>
<div class="line"><a id="l01723" name="l01723"></a><span class="lineno"> 1723</span> </div>
<div class="line"><a id="l01724" name="l01724"></a><span class="lineno"> 1724</span>    <span class="comment">// Next do the actual parsing of each static Option_set.  Stop at first failure.  Return `true` iff total success.</span></div>
<div class="line"><a id="l01725" name="l01725"></a><span class="lineno"> 1725</span>    success = apply_static_or_dynamic_impl&lt;Value_set...&gt;</div>
<div class="line"><a id="l01726" name="l01726"></a><span class="lineno"> 1726</span>                (<span class="keyword">false</span>, <span class="comment">// false =&gt; static.</span></div>
<div class="line"><a id="l01727" name="l01727"></a><span class="lineno"> 1727</span>                 static_cfg_path, all_opt_names, final_validator_func...);</div>
<div class="line"><a id="l01728" name="l01728"></a><span class="lineno"> 1728</span>  } <span class="comment">// if (success) (but it may have become false inside)</span></div>
<div class="line"><a id="l01729" name="l01729"></a><span class="lineno"> 1729</span> </div>
<div class="line"><a id="l01730" name="l01730"></a><span class="lineno"> 1730</span>  <span class="keywordflow">if</span> ((!commit) &amp;&amp; success)</div>
<div class="line"><a id="l01731" name="l01731"></a><span class="lineno"> 1731</span>  {</div>
<div class="line"><a id="l01732" name="l01732"></a><span class="lineno"> 1732</span>    m_multi_src_update_in_progress = Update_type::S_STATIC; <span class="comment">// (Was either NONE or already this.)</span></div>
<div class="line"><a id="l01733" name="l01733"></a><span class="lineno"> 1733</span>    <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Multi-source update has successfully begun or continued.  &quot;</span></div>
<div class="line"><a id="l01734" name="l01734"></a><span class="lineno"> 1734</span>                  <span class="stringliteral">&quot;Expecting more sources before we can canonicalize candidate(s).&quot;</span>);</div>
<div class="line"><a id="l01735" name="l01735"></a><span class="lineno"> 1735</span>    <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a id="l01736" name="l01736"></a><span class="lineno"> 1736</span>  }</div>
<div class="line"><a id="l01737" name="l01737"></a><span class="lineno"> 1737</span>  <span class="comment">// else if (commit || (!success)):</span></div>
<div class="line"><a id="l01738" name="l01738"></a><span class="lineno"> 1738</span> </div>
<div class="line"><a id="l01739" name="l01739"></a><span class="lineno"> 1739</span>  <span class="comment">/* !success =&gt; reject, regardless of commit (a failure aborts a multi-source update too).</span></div>
<div class="line"><a id="l01740" name="l01740"></a><span class="lineno"> 1740</span><span class="comment">   * commit =&gt; accept or reject depending on `success`.</span></div>
<div class="line"><a id="l01741" name="l01741"></a><span class="lineno"> 1741</span><span class="comment">   *</span></div>
<div class="line"><a id="l01742" name="l01742"></a><span class="lineno"> 1742</span><span class="comment">   * So finally either canonicalize or reject each parse attempt depending on overall `success` (static only).</span></div>
<div class="line"><a id="l01743" name="l01743"></a><span class="lineno"> 1743</span><span class="comment">   * For details on what that means see Option_set&lt;&gt; docs.  Basically it just finalizes the parsing by updating</span></div>
<div class="line"><a id="l01744" name="l01744"></a><span class="lineno"> 1744</span><span class="comment">   * the canonically stored Value_set inside the Option_set&lt;Value_set&gt;.  Until then it&#39;s stored to the side as the</span></div>
<div class="line"><a id="l01745" name="l01745"></a><span class="lineno"> 1745</span><span class="comment">   * *candidate*. */</span></div>
<div class="line"><a id="l01746" name="l01746"></a><span class="lineno"> 1746</span>  value_set_idx = 0;</div>
<div class="line"><a id="l01747" name="l01747"></a><span class="lineno"> 1747</span>  (</div>
<div class="line"><a id="l01748" name="l01748"></a><span class="lineno"> 1748</span>    ...,</div>
<div class="line"><a id="l01749" name="l01749"></a><span class="lineno"> 1749</span>    (</div>
<div class="line"><a id="l01750" name="l01750"></a><span class="lineno"> 1750</span>      option_set_canonicalize_or_reject(opt_set&lt;Value_set&gt;(value_set_idx), <span class="comment">// Param pack expansion kernel here.</span></div>
<div class="line"><a id="l01751" name="l01751"></a><span class="lineno"> 1751</span>                                        success, 0),</div>
<div class="line"><a id="l01752" name="l01752"></a><span class="lineno"> 1752</span>      value_set_idx += 2 <span class="comment">// Skip dynamic ones.</span></div>
<div class="line"><a id="l01753" name="l01753"></a><span class="lineno"> 1753</span>    )</div>
<div class="line"><a id="l01754" name="l01754"></a><span class="lineno"> 1754</span>  );</div>
<div class="line"><a id="l01755" name="l01755"></a><span class="lineno"> 1755</span> </div>
<div class="line"><a id="l01756" name="l01756"></a><span class="lineno"> 1756</span>  <span class="keywordflow">if</span> (m_multi_src_update_in_progress != Update_type::S_NONE)</div>
<div class="line"><a id="l01757" name="l01757"></a><span class="lineno"> 1757</span>  {</div>
<div class="line"><a id="l01758" name="l01758"></a><span class="lineno"> 1758</span>    <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Multi-source update is now finished.&quot;</span>);</div>
<div class="line"><a id="l01759" name="l01759"></a><span class="lineno"> 1759</span>    m_multi_src_update_in_progress = Update_type::S_NONE;</div>
<div class="line"><a id="l01760" name="l01760"></a><span class="lineno"> 1760</span>  }</div>
<div class="line"><a id="l01761" name="l01761"></a><span class="lineno"> 1761</span>  <span class="comment">// else { It was NONE and remains so, either due to failure or being a vanilla (single-source) update or both. }</span></div>
<div class="line"><a id="l01762" name="l01762"></a><span class="lineno"> 1762</span> </div>
<div class="line"><a id="l01763" name="l01763"></a><span class="lineno"> 1763</span>  <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: State that was just made canonical follows.&quot;</span>);</div>
<div class="line"><a id="l01764" name="l01764"></a><span class="lineno"> 1764</span>  log_state(); <span class="comment">// Note this will auto-skip dynamic sets which should all be Null_state and hence .null().</span></div>
<div class="line"><a id="l01765" name="l01765"></a><span class="lineno"> 1765</span> </div>
<div class="line"><a id="l01766" name="l01766"></a><span class="lineno"> 1766</span>  <span class="keywordflow">return</span> success;</div>
<div class="line"><a id="l01767" name="l01767"></a><span class="lineno"> 1767</span>} <span class="comment">// Config_manager::apply_static_impl()</span></div>
<div class="line"><a id="l01768" name="l01768"></a><span class="lineno"> 1768</span> </div>
<div class="line"><a id="l01769" name="l01769"></a><span class="lineno"> 1769</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l01770" name="l01770"></a><span class="lineno"> 1770</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l01771" name="l01771"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#aa7785bcdb7fae9ae7ef6f1919b1f8045"> 1771</a></span><span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#aa7785bcdb7fae9ae7ef6f1919b1f8045">Config_manager&lt;S_d_value_set...&gt;::apply_static_or_dynamic_impl</a></div>
<div class="line"><a id="l01772" name="l01772"></a><span class="lineno"> 1772</span>       (<span class="keywordtype">bool</span> dyn_else_st, <span class="keyword">const</span> fs::path&amp; cfg_path, <span class="keyword">const</span> boost::unordered_set&lt;std::string&gt;&amp; all_opt_names_or_empty,</div>
<div class="line"><a id="l01773" name="l01773"></a><span class="lineno"> 1773</span>        <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;Value_set&gt;::Type</a>&amp;... final_validator_func)</div>
<div class="line"><a id="l01774" name="l01774"></a><span class="lineno"> 1774</span>{</div>
<div class="line"><a id="l01775" name="l01775"></a><span class="lineno"> 1775</span>  <span class="keywordtype">size_t</span> s_d_value_set_idx = 0;</div>
<div class="line"><a id="l01776" name="l01776"></a><span class="lineno"> 1776</span>  <span class="keywordtype">size_t</span> value_set_idx = dyn_else_st ? 1 : 0;</div>
<div class="line"><a id="l01777" name="l01777"></a><span class="lineno"> 1777</span> </div>
<div class="line"><a id="l01778" name="l01778"></a><span class="lineno"> 1778</span>  <span class="comment">/* Flag for the skipping of parsing and validation.  Becomes true and stays true once one of the</span></div>
<div class="line"><a id="l01779" name="l01779"></a><span class="lineno"> 1779</span><span class="comment">   * final_validator_func()s yields S_SKIP. */</span></div>
<div class="line"><a id="l01780" name="l01780"></a><span class="lineno"> 1780</span>  <span class="keywordtype">bool</span> skip_parsing = <span class="keyword">false</span>;</div>
<div class="line"><a id="l01781" name="l01781"></a><span class="lineno"> 1781</span> </div>
<div class="line"><a id="l01782" name="l01782"></a><span class="lineno"> 1782</span>  <span class="keywordtype">bool</span> success;</div>
<div class="line"><a id="l01783" name="l01783"></a><span class="lineno"> 1783</span>  <span class="keywordflow">return</span></div>
<div class="line"><a id="l01784" name="l01784"></a><span class="lineno"> 1784</span>    (</div>
<div class="line"><a id="l01785" name="l01785"></a><span class="lineno"> 1785</span>      ...</div>
<div class="line"><a id="l01786" name="l01786"></a><span class="lineno"> 1786</span>      &amp;&amp;</div>
<div class="line"><a id="l01787" name="l01787"></a><span class="lineno"> 1787</span>      (</div>
<div class="line"><a id="l01788" name="l01788"></a><span class="lineno"> 1788</span>        <span class="comment">/* 2nd apply_impl() arg: If we&#39;re called from apply_dynamic(), supply the pre-parse baseline state, but only</span></div>
<div class="line"><a id="l01789" name="l01789"></a><span class="lineno"> 1789</span><span class="comment">         * if this isn&#39;t the 2nd/3rd/... apply_dynamic() of a multi-source (commit=false) sequence.</span></div>
<div class="line"><a id="l01790" name="l01790"></a><span class="lineno"> 1790</span><span class="comment">         * (If it&#39;s a null Option_set, then it&#39;ll be ignored by the no-op apply_impl().</span></div>
<div class="line"><a id="l01791" name="l01791"></a><span class="lineno"> 1791</span><span class="comment">         * Pass null.)</span></div>
<div class="line"><a id="l01792" name="l01792"></a><span class="lineno"> 1792</span><span class="comment">         * If we&#39;re called from apply_static(), it only happens once and is not relevant.</span></div>
<div class="line"><a id="l01793" name="l01793"></a><span class="lineno"> 1793</span><span class="comment">         * Pass null.</span></div>
<div class="line"><a id="l01794" name="l01794"></a><span class="lineno"> 1794</span><span class="comment">         * If it is the 2nd/3rd/... apply_dynamic() of a multi-source (commit=false) sequence, the pre-parse</span></div>
<div class="line"><a id="l01795" name="l01795"></a><span class="lineno"> 1795</span><span class="comment">         * baseline state has already been applied; and we don&#39;t want to blow away the incrementally built-up candidate</span></div>
<div class="line"><a id="l01796" name="l01796"></a><span class="lineno"> 1796</span><span class="comment">         * stored inside Value_set opt_set&lt;&gt;().</span></div>
<div class="line"><a id="l01797" name="l01797"></a><span class="lineno"> 1797</span><span class="comment">         * Pass null.</span></div>
<div class="line"><a id="l01798" name="l01798"></a><span class="lineno"> 1798</span><span class="comment">         * We are never called from apply_static_and_dynamic() which, itself,</span></div>
<div class="line"><a id="l01799" name="l01799"></a><span class="lineno"> 1799</span><span class="comment">         * sets that baseline state for later use in apply_dynamic() and hence here. */</span></div>
<div class="line"><a id="l01800" name="l01800"></a><span class="lineno"> 1800</span>        success = apply_impl(opt_set&lt;Value_set&gt; <span class="comment">// Param pack expansion kernel here.</span></div>
<div class="line"><a id="l01801" name="l01801"></a><span class="lineno"> 1801</span>                               (value_set_idx), <span class="comment">// 1, 3, 5, ... -or- 0, 2, 4, ....</span></div>
<div class="line"><a id="l01802" name="l01802"></a><span class="lineno"> 1802</span> </div>
<div class="line"><a id="l01803" name="l01803"></a><span class="lineno"> 1803</span>                             ((m_multi_src_update_in_progress == Update_type::S_NONE)</div>
<div class="line"><a id="l01804" name="l01804"></a><span class="lineno"> 1804</span>                                &amp;&amp; dyn_else_st &amp;&amp; (!opt_set&lt;Value_set&gt;(value_set_idx)-&gt;null()))</div>
<div class="line"><a id="l01805" name="l01805"></a><span class="lineno"> 1805</span>                               ? d_baseline_value_set&lt;Value_set&gt; <span class="comment">// (And here.)</span></div>
<div class="line"><a id="l01806" name="l01806"></a><span class="lineno"> 1806</span>                                   (s_d_value_set_idx)</div>
<div class="line"><a id="l01807" name="l01807"></a><span class="lineno"> 1807</span>                               : <span class="keyword">static_cast&lt;</span><span class="keyword">const </span>Value_set*<span class="keyword">&gt;</span>(0), <span class="comment">// (And here.)</span></div>
<div class="line"><a id="l01808" name="l01808"></a><span class="lineno"> 1808</span> </div>
<div class="line"><a id="l01809" name="l01809"></a><span class="lineno"> 1809</span>                             cfg_path, all_opt_names_or_empty,</div>
<div class="line"><a id="l01810" name="l01810"></a><span class="lineno"> 1810</span>                             final_validator_func, <span class="comment">// (And here.)</span></div>
<div class="line"><a id="l01811" name="l01811"></a><span class="lineno"> 1811</span>                             &amp;skip_parsing),</div>
<div class="line"><a id="l01812" name="l01812"></a><span class="lineno"> 1812</span>        ++s_d_value_set_idx,</div>
<div class="line"><a id="l01813" name="l01813"></a><span class="lineno"> 1813</span>        value_set_idx += 2,</div>
<div class="line"><a id="l01814" name="l01814"></a><span class="lineno"> 1814</span>        success <span class="comment">// Stop apply_impl()ing on first failure (the `&amp;&amp;` will evaluate to false early).</span></div>
<div class="line"><a id="l01815" name="l01815"></a><span class="lineno"> 1815</span>      )</div>
<div class="line"><a id="l01816" name="l01816"></a><span class="lineno"> 1816</span>    );</div>
<div class="line"><a id="l01817" name="l01817"></a><span class="lineno"> 1817</span>} <span class="comment">// Config_manager::apply_static_or_dynamic_impl()</span></div>
<div class="line"><a id="l01818" name="l01818"></a><span class="lineno"> 1818</span> </div>
<div class="line"><a id="l01819" name="l01819"></a><span class="lineno"> 1819</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l01820" name="l01820"></a><span class="lineno"> 1820</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l01821" name="l01821"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#ac416a9ecc83d4209b5b9767d01984aa3"> 1821</a></span><span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#ac416a9ecc83d4209b5b9767d01984aa3">Config_manager&lt;S_d_value_set...&gt;::apply_impl</a></div>
<div class="line"><a id="l01822" name="l01822"></a><span class="lineno"> 1822</span>       (<a class="code hl_class" href="classflow_1_1cfg_1_1Option__set.html">Option_set&lt;Value_set&gt;</a>* opt_set,</div>
<div class="line"><a id="l01823" name="l01823"></a><span class="lineno"> 1823</span>        <span class="keyword">const</span> Value_set* baseline_value_set_or_null,</div>
<div class="line"><a id="l01824" name="l01824"></a><span class="lineno"> 1824</span>        <span class="keyword">const</span> fs::path&amp; cfg_path,</div>
<div class="line"><a id="l01825" name="l01825"></a><span class="lineno"> 1825</span>        <span class="keyword">const</span> boost::unordered_set&lt;std::string&gt;&amp; all_opt_names_or_empty,</div>
<div class="line"><a id="l01826" name="l01826"></a><span class="lineno"> 1826</span>        <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;Value_set&gt;::Type</a>&amp; final_validator_func,</div>
<div class="line"><a id="l01827" name="l01827"></a><span class="lineno"> 1827</span>        <span class="keywordtype">bool</span>* skip_parsing)</div>
<div class="line"><a id="l01828" name="l01828"></a><span class="lineno"> 1828</span>{</div>
<div class="line"><a id="l01829" name="l01829"></a><span class="lineno"> 1829</span>  assert(opt_set);</div>
<div class="line"><a id="l01830" name="l01830"></a><span class="lineno"> 1830</span>  <span class="keyword">auto</span>&amp; opts = *opt_set;</div>
<div class="line"><a id="l01831" name="l01831"></a><span class="lineno"> 1831</span> </div>
<div class="line"><a id="l01832" name="l01832"></a><span class="lineno"> 1832</span>  <span class="keywordflow">if</span> (opts.null())</div>
<div class="line"><a id="l01833" name="l01833"></a><span class="lineno"> 1833</span>  {</div>
<div class="line"><a id="l01834" name="l01834"></a><span class="lineno"> 1834</span>    <span class="keywordflow">return</span> <span class="keyword">true</span>; <span class="comment">// By the way notice, as advertised, final_validator_func is ignored.</span></div>
<div class="line"><a id="l01835" name="l01835"></a><span class="lineno"> 1835</span>  }</div>
<div class="line"><a id="l01836" name="l01836"></a><span class="lineno"> 1836</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l01837" name="l01837"></a><span class="lineno"> 1837</span> </div>
<div class="line"><a id="l01838" name="l01838"></a><span class="lineno"> 1838</span>  <span class="comment">/* For some sets (namely dynamic ones, at most) we need to pre-apply the full set of baseline values.</span></div>
<div class="line"><a id="l01839" name="l01839"></a><span class="lineno"> 1839</span><span class="comment">   * This is explained in m_d_baseline_value_sets doc header; but basically it&#39;s so that successive dynamic updates</span></div>
<div class="line"><a id="l01840" name="l01840"></a><span class="lineno"> 1840</span><span class="comment">   * always apply the change in the file on top of a consistent state.  Otherwise it&#39;s impossible to know, just by</span></div>
<div class="line"><a id="l01841" name="l01841"></a><span class="lineno"> 1841</span><span class="comment">   * looking at the dynamic config file, what the resulting state will be in memory -- incremental is bad in this</span></div>
<div class="line"><a id="l01842" name="l01842"></a><span class="lineno"> 1842</span><span class="comment">   * context. */</span></div>
<div class="line"><a id="l01843" name="l01843"></a><span class="lineno"> 1843</span>  <span class="keywordflow">if</span> (baseline_value_set_or_null)</div>
<div class="line"><a id="l01844" name="l01844"></a><span class="lineno"> 1844</span>  {</div>
<div class="line"><a id="l01845" name="l01845"></a><span class="lineno"> 1845</span>    opts.<a class="code hl_function" href="classflow_1_1cfg_1_1Option__set.html#afcd900a94beabe8e9964efc3bc1b91bc">parse_direct_values</a>(*baseline_value_set_or_null);</div>
<div class="line"><a id="l01846" name="l01846"></a><span class="lineno"> 1846</span>  }</div>
<div class="line"><a id="l01847" name="l01847"></a><span class="lineno"> 1847</span> </div>
<div class="line"><a id="l01848" name="l01848"></a><span class="lineno"> 1848</span>  <span class="comment">/* We allow final_validator_func()==SKIP, which means the validator decided the candidate Value_set is not</span></div>
<div class="line"><a id="l01849" name="l01849"></a><span class="lineno"> 1849</span><span class="comment">   * erroneous but has something there that means this particular apply_impl() shall have no effect on the candidate</span></div>
<div class="line"><a id="l01850" name="l01850"></a><span class="lineno"> 1850</span><span class="comment">   * after all.  To make this work we must memorize the pre-parse state; as Option_set doesn&#39;t know about</span></div>
<div class="line"><a id="l01851" name="l01851"></a><span class="lineno"> 1851</span><span class="comment">   * final-validation or skipping and will have updated .values_candidate() (otherwise) irreversibly.  We, however,</span></div>
<div class="line"><a id="l01852" name="l01852"></a><span class="lineno"> 1852</span><span class="comment">   * can simply undo it via .parse_direct_values() or .reject_candidate().</span></div>
<div class="line"><a id="l01853" name="l01853"></a><span class="lineno"> 1853</span><span class="comment">   *</span></div>
<div class="line"><a id="l01854" name="l01854"></a><span class="lineno"> 1854</span><span class="comment">   * Subtlety: If, in this possibly-multi-source update, this is the 1st source, then opt_set-&gt;values_candidate() may be</span></div>
<div class="line"><a id="l01855" name="l01855"></a><span class="lineno"> 1855</span><span class="comment">   * null (*opt_set is not in PARSING state but CANONICAL still).  One option is to do what we do: save the canonical</span></div>
<div class="line"><a id="l01856" name="l01856"></a><span class="lineno"> 1856</span><span class="comment">   * value-set instead; then if rewinding below, it&#39;ll stay in PARSING state but have the unchanged canonical values.</span></div>
<div class="line"><a id="l01857" name="l01857"></a><span class="lineno"> 1857</span><span class="comment">   * Another option is to, instead, save nothing and when rewinding below in that case</span></div>
<div class="line"><a id="l01858" name="l01858"></a><span class="lineno"> 1858</span><span class="comment">   * reject_candidate() and thus bring *opt_set to CANONICAL state again.  That may seem a bit more complex but more</span></div>
<div class="line"><a id="l01859" name="l01859"></a><span class="lineno"> 1859</span><span class="comment">   * elegant, but it leads to a subtle bug: If the possibly-multi-source update&#39;s final-validators *all* return SKIP --</span></div>
<div class="line"><a id="l01860" name="l01860"></a><span class="lineno"> 1860</span><span class="comment">   * which is arguably unusual but certainly allowed -- then apply_*() near its end will happily attempt to</span></div>
<div class="line"><a id="l01861" name="l01861"></a><span class="lineno"> 1861</span><span class="comment">   * opt_set-&gt;canonicalize_candidate() -- which will fail (possibly assert-trip) due to being invoked in</span></div>
<div class="line"><a id="l01862" name="l01862"></a><span class="lineno"> 1862</span><span class="comment">   * already-CANONICAL state.  So our choices are to go with the just-save-values() route, or to -- elsewhere</span></div>
<div class="line"><a id="l01863" name="l01863"></a><span class="lineno"> 1863</span><span class="comment">   * in apply_*() themselves -- guard -&gt;canonicalize_candidate() with a check for the everything-SKIPped situation.</span></div>
<div class="line"><a id="l01864" name="l01864"></a><span class="lineno"> 1864</span><span class="comment">   * Both are okay, but the former approach is simpler, avoiding at least a couple of if-branches in a couple of</span></div>
<div class="line"><a id="l01865" name="l01865"></a><span class="lineno"> 1865</span><span class="comment">   * places.  It involves potentially 2 extra copy-ops of a Value_set; but so what?  In the grand scheme the perf</span></div>
<div class="line"><a id="l01866" name="l01866"></a><span class="lineno"> 1866</span><span class="comment">   * impact is negligible. */</span></div>
<div class="line"><a id="l01867" name="l01867"></a><span class="lineno"> 1867</span>  <span class="keyword">const</span> <span class="keyword">auto</span> candidate_or_null = opt_set-&gt;<a class="code hl_function" href="classflow_1_1cfg_1_1Option__set.html#adce212853383183bd1b60505157f7215">values_candidate</a>();</div>
<div class="line"><a id="l01868" name="l01868"></a><span class="lineno"> 1868</span>  <span class="keyword">const</span> <span class="keyword">auto</span> pre_parse_candidate = candidate_or_null ? *candidate_or_null : opt_set-&gt;<a class="code hl_function" href="classflow_1_1cfg_1_1Option__set.html#a93ab889bf230d21961c22bd4bf21e06a">values</a>();</div>
<div class="line"><a id="l01869" name="l01869"></a><span class="lineno"> 1869</span> </div>
<div class="line"><a id="l01870" name="l01870"></a><span class="lineno"> 1870</span>  <span class="comment">/* Ready to parse... but act as-if parse was fine but yielded SKIP, if told we&#39;re already in skipping mode</span></div>
<div class="line"><a id="l01871" name="l01871"></a><span class="lineno"> 1871</span><span class="comment">   * (from previous `Value_set`s, probably, though formally by contract this method doesn&#39;t care why). */</span></div>
<div class="line"><a id="l01872" name="l01872"></a><span class="lineno"> 1872</span>  <span class="keywordflow">if</span> (skip_parsing &amp;&amp; (*skip_parsing))</div>
<div class="line"><a id="l01873" name="l01873"></a><span class="lineno"> 1873</span>  {</div>
<div class="line"><a id="l01874" name="l01874"></a><span class="lineno"> 1874</span>    <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: &quot;</span></div>
<div class="line"><a id="l01875" name="l01875"></a><span class="lineno"> 1875</span>                  <span class="stringliteral">&quot;Parsing, individual-option validation, and final-validation are being skipped &quot;</span></div>
<div class="line"><a id="l01876" name="l01876"></a><span class="lineno"> 1876</span>                  <span class="stringliteral">&quot;for this value set, as requested by the caller.  This file&#39;s values will not be applied.  &quot;</span></div>
<div class="line"><a id="l01877" name="l01877"></a><span class="lineno"> 1877</span>                  <span class="stringliteral">&quot;This has happened because this value set is successive to a value set whose &quot;</span></div>
<div class="line"><a id="l01878" name="l01878"></a><span class="lineno"> 1878</span>                  <span class="stringliteral">&quot;final-validation determined that it shall not be applied.  This is not an error.&quot;</span>);</div>
<div class="line"><a id="l01879" name="l01879"></a><span class="lineno"> 1879</span>    opts.parse_direct_values(pre_parse_candidate);</div>
<div class="line"><a id="l01880" name="l01880"></a><span class="lineno"> 1880</span>    <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a id="l01881" name="l01881"></a><span class="lineno"> 1881</span>  }</div>
<div class="line"><a id="l01882" name="l01882"></a><span class="lineno"> 1882</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l01883" name="l01883"></a><span class="lineno"> 1883</span> </div>
<div class="line"><a id="l01884" name="l01884"></a><span class="lineno"> 1884</span>  <span class="comment">/* We allow unknown (to this Option_set&lt;Value_set&gt; `opts`) options in the file during the initial parse -- but</span></div>
<div class="line"><a id="l01885" name="l01885"></a><span class="lineno"> 1885</span><span class="comment">   * only the ones that are themselves options but in other Option_sets we&#39;re also parsing (since non-hard-coded options</span></div>
<div class="line"><a id="l01886" name="l01886"></a><span class="lineno"> 1886</span><span class="comment">   * are not being parsed in this file, no other options should be present -- forward-compatibility, etc., not a</span></div>
<div class="line"><a id="l01887" name="l01887"></a><span class="lineno"> 1887</span><span class="comment">   * factor with a hard-coded file).  Hence simply pass in all option names (including this one&#39;s, but they&#39;ll</span></div>
<div class="line"><a id="l01888" name="l01888"></a><span class="lineno"> 1888</span><span class="comment">   * just be parsed as belonging to this actual set and hence not be relevant to the unknown-option-name check).</span></div>
<div class="line"><a id="l01889" name="l01889"></a><span class="lineno"> 1889</span><span class="comment">   *</span></div>
<div class="line"><a id="l01890" name="l01890"></a><span class="lineno"> 1890</span><span class="comment">   * If it&#39;s not an initial parse then all_opt_names_or_empty will be empty, meaning simply allow all unknown options;</span></div>
<div class="line"><a id="l01891" name="l01891"></a><span class="lineno"> 1891</span><span class="comment">   * due to forward/backward-compatibility we just allow it and log such things but ignore them otherwise. */</span></div>
<div class="line"><a id="l01892" name="l01892"></a><span class="lineno"> 1892</span>  <span class="keywordtype">bool</span> ok;</div>
<div class="line"><a id="l01893" name="l01893"></a><span class="lineno"> 1893</span>  opts.parse_config_file(cfg_path, <span class="keyword">true</span>, &amp;ok, all_opt_names_or_empty);</div>
<div class="line"><a id="l01894" name="l01894"></a><span class="lineno"> 1894</span> </div>
<div class="line"><a id="l01895" name="l01895"></a><span class="lineno"> 1895</span>  <span class="comment">/* parse_config_file() specifically promises not to individually-validate values not in the actual file.</span></div>
<div class="line"><a id="l01896" name="l01896"></a><span class="lineno"> 1896</span><span class="comment">   * So before returning success (likely causing to finalize values via opts.canonicalize_candidate()) ensure</span></div>
<div class="line"><a id="l01897" name="l01897"></a><span class="lineno"> 1897</span><span class="comment">   * any invalid defaults don&#39;t &quot;fall through.&quot;  This is unnecessary if defaults were scanned individually</span></div>
<div class="line"><a id="l01898" name="l01898"></a><span class="lineno"> 1898</span><span class="comment">   * due to allow_invalid_defaults==false; but in that case it is harmless (as of this writing won&#39;t even log). */</span></div>
<div class="line"><a id="l01899" name="l01899"></a><span class="lineno"> 1899</span>  <span class="keywordflow">if</span> (ok)</div>
<div class="line"><a id="l01900" name="l01900"></a><span class="lineno"> 1900</span>  {</div>
<div class="line"><a id="l01901" name="l01901"></a><span class="lineno"> 1901</span>    opts.validate_values_candidate(&amp;ok);</div>
<div class="line"><a id="l01902" name="l01902"></a><span class="lineno"> 1902</span>    <span class="keywordflow">if</span> (!ok) <span class="comment">// It would have logged the exact problem, but we still want to clearly say what happened, high-level:</span></div>
<div class="line"><a id="l01903" name="l01903"></a><span class="lineno"> 1903</span>    {</div>
<div class="line"><a id="l01904" name="l01904"></a><span class="lineno"> 1904</span>      <a class="code hl_define" href="log_8hpp.html#a626c7dc4d3b4dc0b32a8aac8624d66bc">FLOW_LOG_WARNING</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: &quot;</span></div>
<div class="line"><a id="l01905" name="l01905"></a><span class="lineno"> 1905</span>                       <span class="stringliteral">&quot;Request to apply config file [&quot;</span> &lt;&lt; cfg_path &lt;&lt; <span class="stringliteral">&quot;] for a particular value set:  &quot;</span></div>
<div class="line"><a id="l01906" name="l01906"></a><span class="lineno"> 1906</span>                       <span class="stringliteral">&quot;Individual values present in file were OK, but at least 1 default value (see above) &quot;</span></div>
<div class="line"><a id="l01907" name="l01907"></a><span class="lineno"> 1907</span>                       <span class="stringliteral">&quot;was invalid.  Either correct the default or ensure it is properly overridden in file.&quot;</span>);</div>
<div class="line"><a id="l01908" name="l01908"></a><span class="lineno"> 1908</span>    }</div>
<div class="line"><a id="l01909" name="l01909"></a><span class="lineno"> 1909</span>  } <span class="comment">// if (ok) (but it may have become false inside)</span></div>
<div class="line"><a id="l01910" name="l01910"></a><span class="lineno"> 1910</span> </div>
<div class="line"><a id="l01911" name="l01911"></a><span class="lineno"> 1911</span>  <span class="keywordflow">if</span> (ok)</div>
<div class="line"><a id="l01912" name="l01912"></a><span class="lineno"> 1912</span>  {</div>
<div class="line"><a id="l01913" name="l01913"></a><span class="lineno"> 1913</span>    <span class="comment">// Lastly, as promised, run their inter-option validation (which can also specify that we skip).</span></div>
<div class="line"><a id="l01914" name="l01914"></a><span class="lineno"> 1914</span>    <span class="keyword">const</span> <span class="keyword">auto</span> final_validator_outcome = final_validator_func(*opts.values_candidate());</div>
<div class="line"><a id="l01915" name="l01915"></a><span class="lineno"> 1915</span>    <span class="keywordflow">switch</span> (final_validator_outcome)</div>
<div class="line"><a id="l01916" name="l01916"></a><span class="lineno"> 1916</span>    {</div>
<div class="line"><a id="l01917" name="l01917"></a><span class="lineno"> 1917</span>    <span class="keywordflow">case</span> <a class="code hl_enumvalue" href="namespaceflow_1_1cfg.html#a80b3319f3d3a657837d0d8b28d22ccc3a655ec6aa779cb1c799c9ba80f24e9567">Final_validator_outcome::S_ACCEPT</a>:</div>
<div class="line"><a id="l01918" name="l01918"></a><span class="lineno"> 1918</span>      <span class="keywordflow">break</span>; <span class="comment">// Cool then.</span></div>
<div class="line"><a id="l01919" name="l01919"></a><span class="lineno"> 1919</span>    <span class="keywordflow">case</span> <a class="code hl_enumvalue" href="namespaceflow_1_1cfg.html#a80b3319f3d3a657837d0d8b28d22ccc3aec1a4aed91659725c96b0b8378dba316">Final_validator_outcome::S_FAIL</a>:</div>
<div class="line"><a id="l01920" name="l01920"></a><span class="lineno"> 1920</span>      ok = <span class="keyword">false</span>; <span class="comment">// Uncool.  It logged.</span></div>
<div class="line"><a id="l01921" name="l01921"></a><span class="lineno"> 1921</span>      <span class="keywordflow">break</span>;</div>
<div class="line"><a id="l01922" name="l01922"></a><span class="lineno"> 1922</span>    <span class="keywordflow">case</span> <a class="code hl_enumvalue" href="namespaceflow_1_1cfg.html#a80b3319f3d3a657837d0d8b28d22ccc3ace64a8fc2c16fb21be22f603ef4d2eec">Final_validator_outcome::S_SKIP</a>: <span class="comment">// Cool-ish.</span></div>
<div class="line"><a id="l01923" name="l01923"></a><span class="lineno"> 1923</span>      <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: &quot;</span></div>
<div class="line"><a id="l01924" name="l01924"></a><span class="lineno"> 1924</span>                    <span class="stringliteral">&quot;Request to apply config file [&quot;</span> &lt;&lt; cfg_path &lt;&lt; <span class="stringliteral">&quot;] for a particular value set:  &quot;</span></div>
<div class="line"><a id="l01925" name="l01925"></a><span class="lineno"> 1925</span>                    <span class="stringliteral">&quot;Individual values present in file were OK, but the final-validator logic specified &quot;</span></div>
<div class="line"><a id="l01926" name="l01926"></a><span class="lineno"> 1926</span>                    <span class="stringliteral">&quot;that this file&#39;s values not be applied (to skip the file after all).  &quot;</span></div>
<div class="line"><a id="l01927" name="l01927"></a><span class="lineno"> 1927</span>                    <span class="stringliteral">&quot;Rewinding the candidate value-set to pre-parse state.  This is not an error.&quot;</span>);</div>
<div class="line"><a id="l01928" name="l01928"></a><span class="lineno"> 1928</span>      opts.parse_direct_values(pre_parse_candidate);</div>
<div class="line"><a id="l01929" name="l01929"></a><span class="lineno"> 1929</span>      <span class="keywordflow">if</span> (skip_parsing)</div>
<div class="line"><a id="l01930" name="l01930"></a><span class="lineno"> 1930</span>      {</div>
<div class="line"><a id="l01931" name="l01931"></a><span class="lineno"> 1931</span>        assert((!*skip_parsing) &amp;&amp; <span class="stringliteral">&quot;We should have `return`ed already.&quot;</span>);</div>
<div class="line"><a id="l01932" name="l01932"></a><span class="lineno"> 1932</span>        *skip_parsing = <span class="keyword">true</span>;</div>
<div class="line"><a id="l01933" name="l01933"></a><span class="lineno"> 1933</span>      }</div>
<div class="line"><a id="l01934" name="l01934"></a><span class="lineno"> 1934</span>    } <span class="comment">// switch (final_validator_outcome).  Compiler should warn if we failed to handle an enum value.</span></div>
<div class="line"><a id="l01935" name="l01935"></a><span class="lineno"> 1935</span>  } <span class="comment">// if (ok) (but it may have become false inside)</span></div>
<div class="line"><a id="l01936" name="l01936"></a><span class="lineno"> 1936</span> </div>
<div class="line"><a id="l01937" name="l01937"></a><span class="lineno"> 1937</span>  <span class="keywordflow">return</span> ok;</div>
<div class="line"><a id="l01938" name="l01938"></a><span class="lineno"> 1938</span>} <span class="comment">// Config_manager::apply_impl()</span></div>
<div class="line"><a id="l01939" name="l01939"></a><span class="lineno"> 1939</span> </div>
<div class="line"><a id="l01940" name="l01940"></a><span class="lineno"> 1940</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l01941" name="l01941"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a9d9811d1b4aab2c4ea3e6813d4161304"> 1941</a></span><span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a9d9811d1b4aab2c4ea3e6813d4161304">Config_manager&lt;S_d_value_set...&gt;::apply_static_and_dynamic</a></div>
<div class="line"><a id="l01942" name="l01942"></a><span class="lineno"> 1942</span>       (<span class="keyword">const</span> fs::path&amp; cfg_path,</div>
<div class="line"><a id="l01943" name="l01943"></a><span class="lineno"> 1943</span>        <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;S_d_value_set&gt;::Type</a>&amp;... final_validator_func,</div>
<div class="line"><a id="l01944" name="l01944"></a><span class="lineno"> 1944</span>        <span class="keywordtype">bool</span> commit)</div>
<div class="line"><a id="l01945" name="l01945"></a><span class="lineno"> 1945</span>{</div>
<div class="line"><a id="l01946" name="l01946"></a><span class="lineno"> 1946</span>  <span class="keywordflow">return</span> apply_static_and_dynamic_impl(<span class="keyword">false</span>, cfg_path, final_validator_func..., commit);</div>
<div class="line"><a id="l01947" name="l01947"></a><span class="lineno"> 1947</span>}</div>
<div class="line"><a id="l01948" name="l01948"></a><span class="lineno"> 1948</span> </div>
<div class="line"><a id="l01949" name="l01949"></a><span class="lineno"> 1949</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l01950" name="l01950"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a5d85fa5a1ed933c9b85444ddb9a416b1"> 1950</a></span><span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a9d9811d1b4aab2c4ea3e6813d4161304">Config_manager&lt;S_d_value_set...&gt;::apply_static_and_dynamic</a></div>
<div class="line"><a id="l01951" name="l01951"></a><span class="lineno"> 1951</span>       (<a class="code hl_enumeration" href="classflow_1_1cfg_1_1Config__manager.html#a6768eb0c92bd11fd84986058903b10d4">allow_invalid_defaults_tag_t</a>,</div>
<div class="line"><a id="l01952" name="l01952"></a><span class="lineno"> 1952</span>        <span class="keyword">const</span> fs::path&amp; cfg_path,</div>
<div class="line"><a id="l01953" name="l01953"></a><span class="lineno"> 1953</span>        <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;S_d_value_set&gt;::Type</a>&amp;... final_validator_func,</div>
<div class="line"><a id="l01954" name="l01954"></a><span class="lineno"> 1954</span>        <span class="keywordtype">bool</span> commit)</div>
<div class="line"><a id="l01955" name="l01955"></a><span class="lineno"> 1955</span>{</div>
<div class="line"><a id="l01956" name="l01956"></a><span class="lineno"> 1956</span>  <span class="keywordflow">return</span> apply_static_and_dynamic_impl(<span class="keyword">true</span>, cfg_path, final_validator_func..., commit);</div>
<div class="line"><a id="l01957" name="l01957"></a><span class="lineno"> 1957</span>}</div>
<div class="line"><a id="l01958" name="l01958"></a><span class="lineno"> 1958</span> </div>
<div class="line"><a id="l01959" name="l01959"></a><span class="lineno"> 1959</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l01960" name="l01960"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a62619206c49b1b39c887162d8b6a2305"> 1960</a></span><span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a62619206c49b1b39c887162d8b6a2305">Config_manager&lt;S_d_value_set...&gt;::apply_static_and_dynamic_impl</a></div>
<div class="line"><a id="l01961" name="l01961"></a><span class="lineno"> 1961</span>       (<span class="keywordtype">bool</span> allow_invalid_defaults,</div>
<div class="line"><a id="l01962" name="l01962"></a><span class="lineno"> 1962</span>        <span class="keyword">const</span> fs::path&amp; cfg_path,</div>
<div class="line"><a id="l01963" name="l01963"></a><span class="lineno"> 1963</span>        <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;S_d_value_set&gt;::Type</a>&amp;... final_validator_func,</div>
<div class="line"><a id="l01964" name="l01964"></a><span class="lineno"> 1964</span>        <span class="keywordtype">bool</span> commit)</div>
<div class="line"><a id="l01965" name="l01965"></a><span class="lineno"> 1965</span>{</div>
<div class="line"><a id="l01966" name="l01966"></a><span class="lineno"> 1966</span>  <span class="keyword">using </span><a class="code hl_typedef" href="namespaceflow_1_1util.html#a5d2247b715da63e4b960909561b90ae7">util::Lock_guard</a>;</div>
<div class="line"><a id="l01967" name="l01967"></a><span class="lineno"> 1967</span>  <span class="keyword">using </span>boost::unordered_set;</div>
<div class="line"><a id="l01968" name="l01968"></a><span class="lineno"> 1968</span>  <span class="keyword">using </span>std::string;</div>
<div class="line"><a id="l01969" name="l01969"></a><span class="lineno"> 1969</span> </div>
<div class="line"><a id="l01970" name="l01970"></a><span class="lineno"> 1970</span>  <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Request to apply config file [&quot;</span> &lt;&lt; cfg_path &lt;&lt; <span class="stringliteral">&quot;] as both &quot;</span></div>
<div class="line"><a id="l01971" name="l01971"></a><span class="lineno"> 1971</span>                <span class="stringliteral">&quot;static config and *baseline* dynamic config.  Parsing in that order for each pair.  &quot;</span></div>
<div class="line"><a id="l01972" name="l01972"></a><span class="lineno"> 1972</span>                <span class="stringliteral">&quot;Invalid defaults allowed if explicitly set in file? = [&quot;</span> &lt;&lt; allow_invalid_defaults &lt;&lt; <span class="stringliteral">&quot;].  &quot;</span></div>
<div class="line"><a id="l01973" name="l01973"></a><span class="lineno"> 1973</span>                <span class="stringliteral">&quot;This application (if successful) shall end with canonicalizing values? = [&quot;</span> &lt;&lt; commit &lt;&lt; <span class="stringliteral">&quot;]; &quot;</span></div>
<div class="line"><a id="l01974" name="l01974"></a><span class="lineno"> 1974</span>                <span class="stringliteral">&quot;multi-source update already in progress (0=none) = [&quot;</span> &lt;&lt; <span class="keywordtype">int</span>(m_multi_src_update_in_progress) &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l01975" name="l01975"></a><span class="lineno"> 1975</span> </div>
<div class="line"><a id="l01976" name="l01976"></a><span class="lineno"> 1976</span>  reject_candidates_if_update_type_changed(Update_type::S_STATIC_AND_DYNAMIC);</div>
<div class="line"><a id="l01977" name="l01977"></a><span class="lineno"> 1977</span> </div>
<div class="line"><a id="l01978" name="l01978"></a><span class="lineno"> 1978</span>  <span class="comment">/* (See class doc header Implementation section for explanation of fold-expression (..., ) trick.)</span></div>
<div class="line"><a id="l01979" name="l01979"></a><span class="lineno"> 1979</span><span class="comment">   *</span></div>
<div class="line"><a id="l01980" name="l01980"></a><span class="lineno"> 1980</span><span class="comment">   * Note, though, that (... &amp;&amp; expr) (of, say, length 4) evaluates to (((expr1 &amp;&amp; expr2) &amp;&amp; expr3) &amp;&amp; expr4);</span></div>
<div class="line"><a id="l01981" name="l01981"></a><span class="lineno"> 1981</span><span class="comment">   * which means it&#39;ll run through the `expr...i...`s until one evaluates to false; then it stops and evaluates</span></div>
<div class="line"><a id="l01982" name="l01982"></a><span class="lineno"> 1982</span><span class="comment">   * no more past that. */</span></div>
<div class="line"><a id="l01983" name="l01983"></a><span class="lineno"> 1983</span> </div>
<div class="line"><a id="l01984" name="l01984"></a><span class="lineno"> 1984</span>  <span class="keywordtype">size_t</span> value_set_idx;</div>
<div class="line"><a id="l01985" name="l01985"></a><span class="lineno"> 1985</span>  <span class="keywordtype">bool</span> success = <span class="keyword">true</span>;</div>
<div class="line"><a id="l01986" name="l01986"></a><span class="lineno"> 1986</span> </div>
<div class="line"><a id="l01987" name="l01987"></a><span class="lineno"> 1987</span>  <span class="comment">/* Optionally scan the defaults themselves for individual-option-validator validity if so requested.</span></div>
<div class="line"><a id="l01988" name="l01988"></a><span class="lineno"> 1988</span><span class="comment">   * However no need to repeat this, if a multi-source update was already in progress. */</span></div>
<div class="line"><a id="l01989" name="l01989"></a><span class="lineno"> 1989</span>  <span class="keywordflow">if</span> ((!allow_invalid_defaults) &amp;&amp; (m_multi_src_update_in_progress == Update_type::S_NONE))</div>
<div class="line"><a id="l01990" name="l01990"></a><span class="lineno"> 1990</span>  {</div>
<div class="line"><a id="l01991" name="l01991"></a><span class="lineno"> 1991</span>    value_set_idx = 0;</div>
<div class="line"><a id="l01992" name="l01992"></a><span class="lineno"> 1992</span>    (</div>
<div class="line"><a id="l01993" name="l01993"></a><span class="lineno"> 1993</span>      ...</div>
<div class="line"><a id="l01994" name="l01994"></a><span class="lineno"> 1994</span>      &amp;&amp;</div>
<div class="line"><a id="l01995" name="l01995"></a><span class="lineno"> 1995</span>      (</div>
<div class="line"><a id="l01996" name="l01996"></a><span class="lineno"> 1996</span>        opt_set&lt;S_d_value_set&gt;(value_set_idx) <span class="comment">// Param pack expansion kernel here.</span></div>
<div class="line"><a id="l01997" name="l01997"></a><span class="lineno"> 1997</span>          -&gt;validate_values(&amp;success), <span class="comment">// Set `success`...</span></div>
<div class="line"><a id="l01998" name="l01998"></a><span class="lineno"> 1998</span>        ++value_set_idx,</div>
<div class="line"><a id="l01999" name="l01999"></a><span class="lineno"> 1999</span>        success <span class="comment">// ...and if it&#39;s false, the subsequent option sets shall be skipped.</span></div>
<div class="line"><a id="l02000" name="l02000"></a><span class="lineno"> 2000</span>      )</div>
<div class="line"><a id="l02001" name="l02001"></a><span class="lineno"> 2001</span>    );</div>
<div class="line"><a id="l02002" name="l02002"></a><span class="lineno"> 2002</span> </div>
<div class="line"><a id="l02003" name="l02003"></a><span class="lineno"> 2003</span>    <span class="keywordflow">if</span> (!success) <span class="comment">// It would have logged the exact problem, but we still want to clearly say what happened, high-level:</span></div>
<div class="line"><a id="l02004" name="l02004"></a><span class="lineno"> 2004</span>    {</div>
<div class="line"><a id="l02005" name="l02005"></a><span class="lineno"> 2005</span>      <a class="code hl_define" href="log_8hpp.html#a626c7dc4d3b4dc0b32a8aac8624d66bc">FLOW_LOG_WARNING</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Request to apply config file [&quot;</span> &lt;&lt; cfg_path &lt;&lt; <span class="stringliteral">&quot;] as both &quot;</span></div>
<div class="line"><a id="l02006" name="l02006"></a><span class="lineno"> 2006</span>                       <span class="stringliteral">&quot;static config and *baseline* dynamic config:  Will not parse file, because stringent check &quot;</span></div>
<div class="line"><a id="l02007" name="l02007"></a><span class="lineno"> 2007</span>                       <span class="stringliteral">&quot;of defaults detected at least 1 individually-invalid default value.  Either correct &quot;</span></div>
<div class="line"><a id="l02008" name="l02008"></a><span class="lineno"> 2008</span>                       <span class="stringliteral">&quot;the default or use apply_static_and_dynamic(allow_invalid_defaults_tag_t) overload.&quot;</span>);</div>
<div class="line"><a id="l02009" name="l02009"></a><span class="lineno"> 2009</span>    }</div>
<div class="line"><a id="l02010" name="l02010"></a><span class="lineno"> 2010</span>  } <span class="comment">// if ((!allow_invalid_defaults) &amp;&amp; (!m_multi_src_update_in_progress))</span></div>
<div class="line"><a id="l02011" name="l02011"></a><span class="lineno"> 2011</span> </div>
<div class="line"><a id="l02012" name="l02012"></a><span class="lineno"> 2012</span>  <span class="comment">// First collect all valid static *and* dynamic option names as required by apply_impl().</span></div>
<div class="line"><a id="l02013" name="l02013"></a><span class="lineno"> 2013</span>  unordered_set&lt;string&gt; all_opt_names;</div>
<div class="line"><a id="l02014" name="l02014"></a><span class="lineno"> 2014</span>  unordered_set&lt;string&gt; this_opt_names;</div>
<div class="line"><a id="l02015" name="l02015"></a><span class="lineno"> 2015</span>  value_set_idx = 0;</div>
<div class="line"><a id="l02016" name="l02016"></a><span class="lineno"> 2016</span>  <span class="keywordflow">if</span> (success) <span class="comment">// Skip all this if failed above.</span></div>
<div class="line"><a id="l02017" name="l02017"></a><span class="lineno"> 2017</span>  {</div>
<div class="line"><a id="l02018" name="l02018"></a><span class="lineno"> 2018</span>    <span class="comment">/* Flag for the skipping of parsing and validation.  Becomes true and stays true once one of the</span></div>
<div class="line"><a id="l02019" name="l02019"></a><span class="lineno"> 2019</span><span class="comment">     * final_validator_func()s yields S_SKIP. */</span></div>
<div class="line"><a id="l02020" name="l02020"></a><span class="lineno"> 2020</span>    <span class="keywordtype">bool</span> skip_parsing = <span class="keyword">false</span>;</div>
<div class="line"><a id="l02021" name="l02021"></a><span class="lineno"> 2021</span> </div>
<div class="line"><a id="l02022" name="l02022"></a><span class="lineno"> 2022</span>    (</div>
<div class="line"><a id="l02023" name="l02023"></a><span class="lineno"> 2023</span>      ...,</div>
<div class="line"><a id="l02024" name="l02024"></a><span class="lineno"> 2024</span>      (</div>
<div class="line"><a id="l02025" name="l02025"></a><span class="lineno"> 2025</span>        this_opt_names = opt_set&lt;S_d_value_set&gt;(value_set_idx)-&gt;option_names(), <span class="comment">// Param pack expansion kernel here.</span></div>
<div class="line"><a id="l02026" name="l02026"></a><span class="lineno"> 2026</span>        all_opt_names.insert(this_opt_names.begin(), this_opt_names.end()),</div>
<div class="line"><a id="l02027" name="l02027"></a><span class="lineno"> 2027</span>        ++value_set_idx</div>
<div class="line"><a id="l02028" name="l02028"></a><span class="lineno"> 2028</span>      )</div>
<div class="line"><a id="l02029" name="l02029"></a><span class="lineno"> 2029</span>    );</div>
<div class="line"><a id="l02030" name="l02030"></a><span class="lineno"> 2030</span> </div>
<div class="line"><a id="l02031" name="l02031"></a><span class="lineno"> 2031</span>    <span class="comment">// Next do the actual parsing of each static *and* dynamic Option_set.</span></div>
<div class="line"><a id="l02032" name="l02032"></a><span class="lineno"> 2032</span>    value_set_idx = 0;</div>
<div class="line"><a id="l02033" name="l02033"></a><span class="lineno"> 2033</span>    (</div>
<div class="line"><a id="l02034" name="l02034"></a><span class="lineno"> 2034</span>      ...</div>
<div class="line"><a id="l02035" name="l02035"></a><span class="lineno"> 2035</span>      &amp;&amp;</div>
<div class="line"><a id="l02036" name="l02036"></a><span class="lineno"> 2036</span>      (</div>
<div class="line"><a id="l02037" name="l02037"></a><span class="lineno"> 2037</span>        success = apply_impl(opt_set&lt;S_d_value_set&gt;(value_set_idx), <span class="comment">// Param pack expansion kernel here.</span></div>
<div class="line"><a id="l02038" name="l02038"></a><span class="lineno"> 2038</span>                             <span class="comment">// Initial (baseline) parse: no need to apply baseline state.</span></div>
<div class="line"><a id="l02039" name="l02039"></a><span class="lineno"> 2039</span>                             <span class="keyword">static_cast&lt;</span><span class="keyword">const </span>S_d_value_set*<span class="keyword">&gt;</span>(0), <span class="comment">// (And here.)</span></div>
<div class="line"><a id="l02040" name="l02040"></a><span class="lineno"> 2040</span>                             cfg_path, all_opt_names,</div>
<div class="line"><a id="l02041" name="l02041"></a><span class="lineno"> 2041</span>                             final_validator_func, <span class="comment">// (And here.)</span></div>
<div class="line"><a id="l02042" name="l02042"></a><span class="lineno"> 2042</span>                             &amp;skip_parsing),</div>
<div class="line"><a id="l02043" name="l02043"></a><span class="lineno"> 2043</span>        ++value_set_idx,</div>
<div class="line"><a id="l02044" name="l02044"></a><span class="lineno"> 2044</span>        success <span class="comment">// Stop apply_impl()ing on first failure.</span></div>
<div class="line"><a id="l02045" name="l02045"></a><span class="lineno"> 2045</span>      )</div>
<div class="line"><a id="l02046" name="l02046"></a><span class="lineno"> 2046</span>    );</div>
<div class="line"><a id="l02047" name="l02047"></a><span class="lineno"> 2047</span>  } <span class="comment">// if (success) (but it may have become false inside)</span></div>
<div class="line"><a id="l02048" name="l02048"></a><span class="lineno"> 2048</span> </div>
<div class="line"><a id="l02049" name="l02049"></a><span class="lineno"> 2049</span>  <span class="keywordflow">if</span> ((!commit) &amp;&amp; success)</div>
<div class="line"><a id="l02050" name="l02050"></a><span class="lineno"> 2050</span>  {</div>
<div class="line"><a id="l02051" name="l02051"></a><span class="lineno"> 2051</span>    m_multi_src_update_in_progress = Update_type::S_STATIC_AND_DYNAMIC; <span class="comment">// (Was either NONE or already this.)</span></div>
<div class="line"><a id="l02052" name="l02052"></a><span class="lineno"> 2052</span>    <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Multi-source update has successfully begun or continued.  &quot;</span></div>
<div class="line"><a id="l02053" name="l02053"></a><span class="lineno"> 2053</span>                  <span class="stringliteral">&quot;Expecting more sources before we can canonicalize candidate(s).&quot;</span>);</div>
<div class="line"><a id="l02054" name="l02054"></a><span class="lineno"> 2054</span>    <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a id="l02055" name="l02055"></a><span class="lineno"> 2055</span>  }</div>
<div class="line"><a id="l02056" name="l02056"></a><span class="lineno"> 2056</span>  <span class="comment">// else if (commit || (!success))</span></div>
<div class="line"><a id="l02057" name="l02057"></a><span class="lineno"> 2057</span> </div>
<div class="line"><a id="l02058" name="l02058"></a><span class="lineno"> 2058</span>  <span class="comment">/* !success =&gt; reject, regardless of commit (a failure aborts a multi-source update too).</span></div>
<div class="line"><a id="l02059" name="l02059"></a><span class="lineno"> 2059</span><span class="comment">   * commit =&gt; accept or reject depending on `success`.</span></div>
<div class="line"><a id="l02060" name="l02060"></a><span class="lineno"> 2060</span><span class="comment">   *</span></div>
<div class="line"><a id="l02061" name="l02061"></a><span class="lineno"> 2061</span><span class="comment">   * So next either canonicalize or reject each parse attempt depending on overall success (static *and* dynamic). */</span></div>
<div class="line"><a id="l02062" name="l02062"></a><span class="lineno"> 2062</span>  value_set_idx = 0;</div>
<div class="line"><a id="l02063" name="l02063"></a><span class="lineno"> 2063</span>  (</div>
<div class="line"><a id="l02064" name="l02064"></a><span class="lineno"> 2064</span>    ...,</div>
<div class="line"><a id="l02065" name="l02065"></a><span class="lineno"> 2065</span>    (</div>
<div class="line"><a id="l02066" name="l02066"></a><span class="lineno"> 2066</span>      <span class="comment">/* Note: If parsing stopped before `value_set_idx` due to failure, rejecting Option_set value_set_idx is a</span></div>
<div class="line"><a id="l02067" name="l02067"></a><span class="lineno"> 2067</span><span class="comment">       * harmless no-op by Option_set docs. */</span></div>
<div class="line"><a id="l02068" name="l02068"></a><span class="lineno"> 2068</span>      option_set_canonicalize_or_reject</div>
<div class="line"><a id="l02069" name="l02069"></a><span class="lineno"> 2069</span>        (opt_set&lt;S_d_value_set&gt;(value_set_idx), <span class="comment">// Param pack expansion kernel here.</span></div>
<div class="line"><a id="l02070" name="l02070"></a><span class="lineno"> 2070</span>         success, 0),</div>
<div class="line"><a id="l02071" name="l02071"></a><span class="lineno"> 2071</span>      ++value_set_idx</div>
<div class="line"><a id="l02072" name="l02072"></a><span class="lineno"> 2072</span>    )</div>
<div class="line"><a id="l02073" name="l02073"></a><span class="lineno"> 2073</span>  );</div>
<div class="line"><a id="l02074" name="l02074"></a><span class="lineno"> 2074</span> </div>
<div class="line"><a id="l02075" name="l02075"></a><span class="lineno"> 2075</span>  <span class="keywordflow">if</span> (m_multi_src_update_in_progress != Update_type::S_NONE)</div>
<div class="line"><a id="l02076" name="l02076"></a><span class="lineno"> 2076</span>  {</div>
<div class="line"><a id="l02077" name="l02077"></a><span class="lineno"> 2077</span>    <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Multi-source update is now finished.&quot;</span>);</div>
<div class="line"><a id="l02078" name="l02078"></a><span class="lineno"> 2078</span>    m_multi_src_update_in_progress = Update_type::S_NONE;</div>
<div class="line"><a id="l02079" name="l02079"></a><span class="lineno"> 2079</span>  }</div>
<div class="line"><a id="l02080" name="l02080"></a><span class="lineno"> 2080</span>  <span class="comment">// else { It was NONE and remains so, either due to failure or being a vanilla (single-source) update or both. }</span></div>
<div class="line"><a id="l02081" name="l02081"></a><span class="lineno"> 2081</span> </div>
<div class="line"><a id="l02082" name="l02082"></a><span class="lineno"> 2082</span>  <span class="keywordflow">if</span> (!success)</div>
<div class="line"><a id="l02083" name="l02083"></a><span class="lineno"> 2083</span>  {</div>
<div class="line"><a id="l02084" name="l02084"></a><span class="lineno"> 2084</span>    <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a id="l02085" name="l02085"></a><span class="lineno"> 2085</span>  }</div>
<div class="line"><a id="l02086" name="l02086"></a><span class="lineno"> 2086</span>  <span class="comment">// else if (success):</span></div>
<div class="line"><a id="l02087" name="l02087"></a><span class="lineno"> 2087</span>  assert(commit &amp;&amp; <span class="stringliteral">&quot;Maintenance bug?  We should have returned above if `!commit` but success==true.&quot;</span>);</div>
<div class="line"><a id="l02088" name="l02088"></a><span class="lineno"> 2088</span> </div>
<div class="line"><a id="l02089" name="l02089"></a><span class="lineno"> 2089</span>  <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: State that was just made canonical follows.&quot;</span>);</div>
<div class="line"><a id="l02090" name="l02090"></a><span class="lineno"> 2090</span>  log_state();</div>
<div class="line"><a id="l02091" name="l02091"></a><span class="lineno"> 2091</span> </div>
<div class="line"><a id="l02092" name="l02092"></a><span class="lineno"> 2092</span>  <span class="comment">/* For dynamic sets only -- we must memorize the current Value_set state into</span></div>
<div class="line"><a id="l02093" name="l02093"></a><span class="lineno"> 2093</span><span class="comment">   * m_d_baseline_value_sets[].  It shall be set as the baseline state before actually parsing dynamic config file</span></div>
<div class="line"><a id="l02094" name="l02094"></a><span class="lineno"> 2094</span><span class="comment">   * contents in apply_dynamic(), each time it is called subsequently. */</span></div>
<div class="line"><a id="l02095" name="l02095"></a><span class="lineno"> 2095</span>  <span class="keywordtype">bool</span> dyn_else_st = <span class="keyword">false</span>;</div>
<div class="line"><a id="l02096" name="l02096"></a><span class="lineno"> 2096</span>  value_set_idx = 0;</div>
<div class="line"><a id="l02097" name="l02097"></a><span class="lineno"> 2097</span>  <span class="keywordtype">size_t</span> d_value_set_idx = 0;</div>
<div class="line"><a id="l02098" name="l02098"></a><span class="lineno"> 2098</span>  (</div>
<div class="line"><a id="l02099" name="l02099"></a><span class="lineno"> 2099</span>    ...,</div>
<div class="line"><a id="l02100" name="l02100"></a><span class="lineno"> 2100</span>    (</div>
<div class="line"><a id="l02101" name="l02101"></a><span class="lineno"> 2101</span>      <span class="comment">/* As noted above, fill an m_d_baseline_value_sets[] but for dynamic sets only.  Note that this will copy</span></div>
<div class="line"><a id="l02102" name="l02102"></a><span class="lineno"> 2102</span><span class="comment">       * a Value_set onto a Value_set (in its entirety).  We could also replace the shared_ptr, but why bother?</span></div>
<div class="line"><a id="l02103" name="l02103"></a><span class="lineno"> 2103</span><span class="comment">       * The code would be longer, and it would be somewhat slower too (still a copy involved).</span></div>
<div class="line"><a id="l02104" name="l02104"></a><span class="lineno"> 2104</span><span class="comment">       *</span></div>
<div class="line"><a id="l02105" name="l02105"></a><span class="lineno"> 2105</span><span class="comment">       * Also skip any null() dynamic set.  (This is `if (dyn_else_st) { ... }` in expression form.) */</span></div>
<div class="line"><a id="l02106" name="l02106"></a><span class="lineno"> 2106</span>      dyn_else_st</div>
<div class="line"><a id="l02107" name="l02107"></a><span class="lineno"> 2107</span>        <span class="comment">// (This is `if (!(...).null()) { ... }` in expression form.)</span></div>
<div class="line"><a id="l02108" name="l02108"></a><span class="lineno"> 2108</span>        &amp;&amp; (opt_set&lt;S_d_value_set&gt;(value_set_idx)-&gt;null()  <span class="comment">// Param pack expansion kernel here.</span></div>
<div class="line"><a id="l02109" name="l02109"></a><span class="lineno"> 2109</span>              || (*(d_baseline_value_set&lt;S_d_value_set&gt;(d_value_set_idx)) <span class="comment">// (And here.)</span></div>
<div class="line"><a id="l02110" name="l02110"></a><span class="lineno"> 2110</span>                    = opt_set&lt;S_d_value_set&gt;(value_set_idx)-&gt;values(), <span class="comment">// (And here.)</span></div>
<div class="line"><a id="l02111" name="l02111"></a><span class="lineno"> 2111</span>                  <span class="keyword">true</span>),</div>
<div class="line"><a id="l02112" name="l02112"></a><span class="lineno"> 2112</span>            ++d_value_set_idx,</div>
<div class="line"><a id="l02113" name="l02113"></a><span class="lineno"> 2113</span>            <span class="keyword">true</span>),</div>
<div class="line"><a id="l02114" name="l02114"></a><span class="lineno"> 2114</span> </div>
<div class="line"><a id="l02115" name="l02115"></a><span class="lineno"> 2115</span>      ++value_set_idx,</div>
<div class="line"><a id="l02116" name="l02116"></a><span class="lineno"> 2116</span>      dyn_else_st = !dyn_else_st</div>
<div class="line"><a id="l02117" name="l02117"></a><span class="lineno"> 2117</span>    )</div>
<div class="line"><a id="l02118" name="l02118"></a><span class="lineno"> 2118</span>  );</div>
<div class="line"><a id="l02119" name="l02119"></a><span class="lineno"> 2119</span> </div>
<div class="line"><a id="l02120" name="l02120"></a><span class="lineno"> 2120</span>  <span class="comment">// Next: Eureka!  Set the dynamic-values pointers for the first time.</span></div>
<div class="line"><a id="l02121" name="l02121"></a><span class="lineno"> 2121</span>  {</div>
<div class="line"><a id="l02122" name="l02122"></a><span class="lineno"> 2122</span>    <a class="code hl_typedef" href="namespaceflow_1_1util.html#a5d2247b715da63e4b960909561b90ae7">Lock_guard</a>&lt;<span class="keyword">decltype</span>(m_d_value_sets_mutex)&gt; lock(m_d_value_sets_mutex);</div>
<div class="line"><a id="l02123" name="l02123"></a><span class="lineno"> 2123</span>    value_set_idx = 0;</div>
<div class="line"><a id="l02124" name="l02124"></a><span class="lineno"> 2124</span>    dyn_else_st = <span class="keyword">false</span>;</div>
<div class="line"><a id="l02125" name="l02125"></a><span class="lineno"> 2125</span>    (</div>
<div class="line"><a id="l02126" name="l02126"></a><span class="lineno"> 2126</span>      ...,</div>
<div class="line"><a id="l02127" name="l02127"></a><span class="lineno"> 2127</span>      (</div>
<div class="line"><a id="l02128" name="l02128"></a><span class="lineno"> 2128</span>        <span class="comment">// Just skip static ones.  (This is `if (dyn_else_st) { ... }` in expression form.)</span></div>
<div class="line"><a id="l02129" name="l02129"></a><span class="lineno"> 2129</span>        dyn_else_st</div>
<div class="line"><a id="l02130" name="l02130"></a><span class="lineno"> 2130</span>          &amp;&amp; (save_dynamic_value_set_locked&lt;S_d_value_set&gt; <span class="comment">// Param pack expansion kernel here.</span></div>
<div class="line"><a id="l02131" name="l02131"></a><span class="lineno"> 2131</span>                (opt_set&lt;S_d_value_set&gt;(value_set_idx), value_set_idx / 2),</div>
<div class="line"><a id="l02132" name="l02132"></a><span class="lineno"> 2132</span>              <span class="keyword">true</span>),</div>
<div class="line"><a id="l02133" name="l02133"></a><span class="lineno"> 2133</span>        ++value_set_idx,</div>
<div class="line"><a id="l02134" name="l02134"></a><span class="lineno"> 2134</span>        dyn_else_st = !dyn_else_st</div>
<div class="line"><a id="l02135" name="l02135"></a><span class="lineno"> 2135</span>      )</div>
<div class="line"><a id="l02136" name="l02136"></a><span class="lineno"> 2136</span>    );</div>
<div class="line"><a id="l02137" name="l02137"></a><span class="lineno"> 2137</span>  } <span class="comment">// Lock_guard lock(m_d_value_sets_mutex);</span></div>
<div class="line"><a id="l02138" name="l02138"></a><span class="lineno"> 2138</span> </div>
<div class="line"><a id="l02139" name="l02139"></a><span class="lineno"> 2139</span>  <span class="comment">// They shouldn&#39;t do apply_static_and_dynamic() except as the first apply*_dynamic() thing.</span></div>
<div class="line"><a id="l02140" name="l02140"></a><span class="lineno"> 2140</span>  assert((!m_dynamic_values_set)</div>
<div class="line"><a id="l02141" name="l02141"></a><span class="lineno"> 2141</span>         &amp;&amp; <span class="stringliteral">&quot;User apparently attempted apply_static_and_dynamic(), but dynamic config was already initialized OK.&quot;</span>);</div>
<div class="line"><a id="l02142" name="l02142"></a><span class="lineno"> 2142</span>  m_dynamic_values_set = <span class="keyword">true</span>;</div>
<div class="line"><a id="l02143" name="l02143"></a><span class="lineno"> 2143</span> </div>
<div class="line"><a id="l02144" name="l02144"></a><span class="lineno"> 2144</span>  <span class="comment">// Finally invoke dynamic &quot;change&quot; listeners for the first time.  (.null() =&gt; no listeners registered.)</span></div>
<div class="line"><a id="l02145" name="l02145"></a><span class="lineno"> 2145</span>  <span class="keywordflow">for</span> (d_value_set_idx = 0; d_value_set_idx != S_N_D_VALUE_SETS; ++d_value_set_idx)</div>
<div class="line"><a id="l02146" name="l02146"></a><span class="lineno"> 2146</span>  {</div>
<div class="line"><a id="l02147" name="l02147"></a><span class="lineno"> 2147</span>    invoke_dynamic_change_listeners(d_value_set_idx, <span class="keyword">true</span>); <span class="comment">// true =&gt; initial.</span></div>
<div class="line"><a id="l02148" name="l02148"></a><span class="lineno"> 2148</span>  }</div>
<div class="line"><a id="l02149" name="l02149"></a><span class="lineno"> 2149</span> </div>
<div class="line"><a id="l02150" name="l02150"></a><span class="lineno"> 2150</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a id="l02151" name="l02151"></a><span class="lineno"> 2151</span>} <span class="comment">// Config_manager::apply_static_and_dynamic_impl()</span></div>
<div class="line"><a id="l02152" name="l02152"></a><span class="lineno"> 2152</span> </div>
<div class="line"><a id="l02153" name="l02153"></a><span class="lineno"> 2153</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02154" name="l02154"></a><span class="lineno"> 2154</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l02155" name="l02155"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a26712af2d38d3afbeb52d21b7012a03c"> 2155</a></span><span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a26712af2d38d3afbeb52d21b7012a03c">Config_manager&lt;S_d_value_set...&gt;::apply_dynamic</a></div>
<div class="line"><a id="l02156" name="l02156"></a><span class="lineno"> 2156</span>       (<span class="keyword">const</span> fs::path&amp; dynamic_cfg_path,</div>
<div class="line"><a id="l02157" name="l02157"></a><span class="lineno"> 2157</span>        <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;Value_set&gt;::Type</a>&amp;... final_validator_func,</div>
<div class="line"><a id="l02158" name="l02158"></a><span class="lineno"> 2158</span>        <span class="keywordtype">bool</span> commit)</div>
<div class="line"><a id="l02159" name="l02159"></a><span class="lineno"> 2159</span>{</div>
<div class="line"><a id="l02160" name="l02160"></a><span class="lineno"> 2160</span>  <span class="keywordflow">return</span> apply_dynamic_impl&lt;Value_set...&gt;(<span class="keyword">false</span>, dynamic_cfg_path, final_validator_func..., commit);</div>
<div class="line"><a id="l02161" name="l02161"></a><span class="lineno"> 2161</span>}</div>
<div class="line"><a id="l02162" name="l02162"></a><span class="lineno"> 2162</span> </div>
<div class="line"><a id="l02163" name="l02163"></a><span class="lineno"> 2163</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02164" name="l02164"></a><span class="lineno"> 2164</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l02165" name="l02165"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a2503b020137aca00a8ee4b81fc921750"> 2165</a></span><span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a26712af2d38d3afbeb52d21b7012a03c">Config_manager&lt;S_d_value_set...&gt;::apply_dynamic</a></div>
<div class="line"><a id="l02166" name="l02166"></a><span class="lineno"> 2166</span>       (<a class="code hl_enumeration" href="classflow_1_1cfg_1_1Config__manager.html#a6768eb0c92bd11fd84986058903b10d4">allow_invalid_defaults_tag_t</a>,</div>
<div class="line"><a id="l02167" name="l02167"></a><span class="lineno"> 2167</span>        <span class="keyword">const</span> fs::path&amp; dynamic_cfg_path,</div>
<div class="line"><a id="l02168" name="l02168"></a><span class="lineno"> 2168</span>        <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;Value_set&gt;::Type</a>&amp;... final_validator_func,</div>
<div class="line"><a id="l02169" name="l02169"></a><span class="lineno"> 2169</span>        <span class="keywordtype">bool</span> commit)</div>
<div class="line"><a id="l02170" name="l02170"></a><span class="lineno"> 2170</span>{</div>
<div class="line"><a id="l02171" name="l02171"></a><span class="lineno"> 2171</span>  <span class="keywordflow">return</span> apply_dynamic_impl&lt;Value_set...&gt;(<span class="keyword">true</span>, dynamic_cfg_path, final_validator_func..., commit);</div>
<div class="line"><a id="l02172" name="l02172"></a><span class="lineno"> 2172</span>}</div>
<div class="line"><a id="l02173" name="l02173"></a><span class="lineno"> 2173</span> </div>
<div class="line"><a id="l02174" name="l02174"></a><span class="lineno"> 2174</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02175" name="l02175"></a><span class="lineno"> 2175</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l02176" name="l02176"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a8864e575c78251d3b8e109f86f29b703"> 2176</a></span><span class="keywordtype">bool</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a8864e575c78251d3b8e109f86f29b703">Config_manager&lt;S_d_value_set...&gt;::apply_dynamic_impl</a></div>
<div class="line"><a id="l02177" name="l02177"></a><span class="lineno"> 2177</span>       (<span class="keywordtype">bool</span> allow_invalid_defaults,</div>
<div class="line"><a id="l02178" name="l02178"></a><span class="lineno"> 2178</span>        <span class="keyword">const</span> fs::path&amp; dynamic_cfg_path,</div>
<div class="line"><a id="l02179" name="l02179"></a><span class="lineno"> 2179</span>        <span class="keyword">const</span> <span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;Value_set&gt;::Type</a>&amp;... final_validator_func,</div>
<div class="line"><a id="l02180" name="l02180"></a><span class="lineno"> 2180</span>        <span class="keywordtype">bool</span> commit)</div>
<div class="line"><a id="l02181" name="l02181"></a><span class="lineno"> 2181</span>{</div>
<div class="line"><a id="l02182" name="l02182"></a><span class="lineno"> 2182</span>  <span class="keyword">using </span><a class="code hl_typedef" href="namespaceflow_1_1util.html#a5d2247b715da63e4b960909561b90ae7">util::Lock_guard</a>;</div>
<div class="line"><a id="l02183" name="l02183"></a><span class="lineno"> 2183</span>  <span class="keyword">using </span><a class="code hl_class" href="classflow_1_1util_1_1String__ostream.html">util::String_ostream</a>;</div>
<div class="line"><a id="l02184" name="l02184"></a><span class="lineno"> 2184</span>  <span class="keyword">using </span>boost::array;</div>
<div class="line"><a id="l02185" name="l02185"></a><span class="lineno"> 2185</span>  <span class="keyword">using </span>std::flush;</div>
<div class="line"><a id="l02186" name="l02186"></a><span class="lineno"> 2186</span> </div>
<div class="line"><a id="l02187" name="l02187"></a><span class="lineno"> 2187</span>  <span class="keywordflow">if</span> (m_dynamic_values_set)</div>
<div class="line"><a id="l02188" name="l02188"></a><span class="lineno"> 2188</span>  {</div>
<div class="line"><a id="l02189" name="l02189"></a><span class="lineno"> 2189</span>    <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: &quot;</span></div>
<div class="line"><a id="l02190" name="l02190"></a><span class="lineno"> 2190</span>                  <span class="stringliteral">&quot;Request to apply dynamic config file [&quot;</span> &lt;&lt; dynamic_cfg_path &lt;&lt; <span class="stringliteral">&quot;].  &quot;</span></div>
<div class="line"><a id="l02191" name="l02191"></a><span class="lineno"> 2191</span>                  <span class="stringliteral">&quot;Initializing dynamic config? = [false].  &quot;</span></div>
<div class="line"><a id="l02192" name="l02192"></a><span class="lineno"> 2192</span>                  <span class="stringliteral">&quot;This application (if successful) shall end with canonicalizing values? = [&quot;</span> &lt;&lt; commit &lt;&lt; <span class="stringliteral">&quot;]; &quot;</span></div>
<div class="line"><a id="l02193" name="l02193"></a><span class="lineno"> 2193</span>                  <span class="stringliteral">&quot;multi-source update already in progress &quot;</span></div>
<div class="line"><a id="l02194" name="l02194"></a><span class="lineno"> 2194</span>                  <span class="stringliteral">&quot;(0=none) = [&quot;</span> &lt;&lt; <span class="keywordtype">int</span>(m_multi_src_update_in_progress) &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l02195" name="l02195"></a><span class="lineno"> 2195</span>  }</div>
<div class="line"><a id="l02196" name="l02196"></a><span class="lineno"> 2196</span>  <span class="keywordflow">else</span></div>
<div class="line"><a id="l02197" name="l02197"></a><span class="lineno"> 2197</span>  {</div>
<div class="line"><a id="l02198" name="l02198"></a><span class="lineno"> 2198</span>    <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: &quot;</span></div>
<div class="line"><a id="l02199" name="l02199"></a><span class="lineno"> 2199</span>                  <span class="stringliteral">&quot;Request to apply dynamic config file [&quot;</span> &lt;&lt; dynamic_cfg_path &lt;&lt; <span class="stringliteral">&quot;].  &quot;</span></div>
<div class="line"><a id="l02200" name="l02200"></a><span class="lineno"> 2200</span>                  <span class="stringliteral">&quot;Initializing dynamic config? = [true].  &quot;</span></div>
<div class="line"><a id="l02201" name="l02201"></a><span class="lineno"> 2201</span>                  <span class="stringliteral">&quot;Invalid defaults allowed if explicitly set in file? = [&quot;</span> &lt;&lt; allow_invalid_defaults &lt;&lt; <span class="stringliteral">&quot;].  &quot;</span></div>
<div class="line"><a id="l02202" name="l02202"></a><span class="lineno"> 2202</span>                  <span class="stringliteral">&quot;This application (if successful) shall end with canonicalizing values? = [&quot;</span> &lt;&lt; commit &lt;&lt; <span class="stringliteral">&quot;]; &quot;</span></div>
<div class="line"><a id="l02203" name="l02203"></a><span class="lineno"> 2203</span>                  <span class="stringliteral">&quot;multi-source update already in progress &quot;</span></div>
<div class="line"><a id="l02204" name="l02204"></a><span class="lineno"> 2204</span>                  <span class="stringliteral">&quot;(0=none) = [&quot;</span> &lt;&lt; <span class="keywordtype">int</span>(m_multi_src_update_in_progress) &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l02205" name="l02205"></a><span class="lineno"> 2205</span>  }</div>
<div class="line"><a id="l02206" name="l02206"></a><span class="lineno"> 2206</span> </div>
<div class="line"><a id="l02207" name="l02207"></a><span class="lineno"> 2207</span>  reject_candidates_if_update_type_changed(Update_type::S_DYNAMIC);</div>
<div class="line"><a id="l02208" name="l02208"></a><span class="lineno"> 2208</span> </div>
<div class="line"><a id="l02209" name="l02209"></a><span class="lineno"> 2209</span>  <span class="comment">/* (See class doc header Implementation section for explanation of fold-expression (..., ) trick.)</span></div>
<div class="line"><a id="l02210" name="l02210"></a><span class="lineno"> 2210</span><span class="comment">   *</span></div>
<div class="line"><a id="l02211" name="l02211"></a><span class="lineno"> 2211</span><span class="comment">   * Note, though, that (... &amp;&amp; expr) (of, say, length 4) evaluates to (((expr1 &amp;&amp; expr2) &amp;&amp; expr3) &amp;&amp; expr4);</span></div>
<div class="line"><a id="l02212" name="l02212"></a><span class="lineno"> 2212</span><span class="comment">   * which means it&#39;ll run through the `expr...i...`s until one evaluates to false; then it stops and evaluates</span></div>
<div class="line"><a id="l02213" name="l02213"></a><span class="lineno"> 2213</span><span class="comment">   * no more past that. */</span></div>
<div class="line"><a id="l02214" name="l02214"></a><span class="lineno"> 2214</span> </div>
<div class="line"><a id="l02215" name="l02215"></a><span class="lineno"> 2215</span>  <span class="keywordtype">size_t</span> value_set_idx;</div>
<div class="line"><a id="l02216" name="l02216"></a><span class="lineno"> 2216</span>  <span class="keywordtype">bool</span> success = <span class="keyword">true</span>;</div>
<div class="line"><a id="l02217" name="l02217"></a><span class="lineno"> 2217</span> </div>
<div class="line"><a id="l02218" name="l02218"></a><span class="lineno"> 2218</span>  <span class="comment">/* Optionally scan the defaults themselves for individual-option-validator validity if so requested and applicable.</span></div>
<div class="line"><a id="l02219" name="l02219"></a><span class="lineno"> 2219</span><span class="comment">   * However no need to repeat this, if a multi-source update was already in progress. */</span></div>
<div class="line"><a id="l02220" name="l02220"></a><span class="lineno"> 2220</span>  <span class="keywordflow">if</span> ((!m_dynamic_values_set) &amp;&amp; (!allow_invalid_defaults) &amp;&amp; (m_multi_src_update_in_progress == Update_type::S_NONE))</div>
<div class="line"><a id="l02221" name="l02221"></a><span class="lineno"> 2221</span>  {</div>
<div class="line"><a id="l02222" name="l02222"></a><span class="lineno"> 2222</span>    value_set_idx = 1; <span class="comment">// 1, 3, 5, ....</span></div>
<div class="line"><a id="l02223" name="l02223"></a><span class="lineno"> 2223</span>    [[maybe_unused]] <span class="keyword">const</span> <span class="keyword">auto</span> dummy = <span class="comment">// Defeats false gcc warning due to trailing `success` when N_D_VALUE_SETS is 1.</span></div>
<div class="line"><a id="l02224" name="l02224"></a><span class="lineno"> 2224</span>    (</div>
<div class="line"><a id="l02225" name="l02225"></a><span class="lineno"> 2225</span>      ...</div>
<div class="line"><a id="l02226" name="l02226"></a><span class="lineno"> 2226</span>      &amp;&amp;</div>
<div class="line"><a id="l02227" name="l02227"></a><span class="lineno"> 2227</span>      (</div>
<div class="line"><a id="l02228" name="l02228"></a><span class="lineno"> 2228</span>        opt_set&lt;Value_set&gt;(value_set_idx) <span class="comment">// Param pack expansion kernel here.</span></div>
<div class="line"><a id="l02229" name="l02229"></a><span class="lineno"> 2229</span>          -&gt;validate_values(&amp;success), <span class="comment">// Set `success`...</span></div>
<div class="line"><a id="l02230" name="l02230"></a><span class="lineno"> 2230</span>        value_set_idx += 2, <span class="comment">// (Skip static ones.)</span></div>
<div class="line"><a id="l02231" name="l02231"></a><span class="lineno"> 2231</span>        success <span class="comment">// ...and if it&#39;s false, the subsequent option sets shall be skipped.</span></div>
<div class="line"><a id="l02232" name="l02232"></a><span class="lineno"> 2232</span>      )</div>
<div class="line"><a id="l02233" name="l02233"></a><span class="lineno"> 2233</span>    );</div>
<div class="line"><a id="l02234" name="l02234"></a><span class="lineno"> 2234</span> </div>
<div class="line"><a id="l02235" name="l02235"></a><span class="lineno"> 2235</span>    <span class="keywordflow">if</span> (!success) <span class="comment">// It would have logged the exact problem, but we still want to clearly say what happened, high-level:</span></div>
<div class="line"><a id="l02236" name="l02236"></a><span class="lineno"> 2236</span>    {</div>
<div class="line"><a id="l02237" name="l02237"></a><span class="lineno"> 2237</span>      <a class="code hl_define" href="log_8hpp.html#a626c7dc4d3b4dc0b32a8aac8624d66bc">FLOW_LOG_WARNING</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: &quot;</span></div>
<div class="line"><a id="l02238" name="l02238"></a><span class="lineno"> 2238</span>                       <span class="stringliteral">&quot;Request to initially-apply dynamic config file [&quot;</span> &lt;&lt; dynamic_cfg_path &lt;&lt; <span class="stringliteral">&quot;]:  &quot;</span></div>
<div class="line"><a id="l02239" name="l02239"></a><span class="lineno"> 2239</span>                       <span class="stringliteral">&quot;Will not parse file, because stringent check &quot;</span></div>
<div class="line"><a id="l02240" name="l02240"></a><span class="lineno"> 2240</span>                       <span class="stringliteral">&quot;of defaults detected at least 1 individually-invalid default value.  Either correct &quot;</span></div>
<div class="line"><a id="l02241" name="l02241"></a><span class="lineno"> 2241</span>                       <span class="stringliteral">&quot;the default or use apply_dynamic(allow_invalid_defaults_tag_t) overload.&quot;</span>);</div>
<div class="line"><a id="l02242" name="l02242"></a><span class="lineno"> 2242</span>    }</div>
<div class="line"><a id="l02243" name="l02243"></a><span class="lineno"> 2243</span>  } <span class="comment">// if ((!m_dynamic_values_set) &amp;&amp; (!allow_invalid_defaults) &amp;&amp; (m_multi_src_update_in_progress == NONE))</span></div>
<div class="line"><a id="l02244" name="l02244"></a><span class="lineno"> 2244</span>  <span class="comment">/* else if (m_multi_src_update_in_progress != NONE) { It has been checked already; don&#39;t repeat. }</span></div>
<div class="line"><a id="l02245" name="l02245"></a><span class="lineno"> 2245</span><span class="comment">   * else if ((!m_dynamic_values_set) &amp;&amp; allow_invalid_defaults) { They don&#39;t want default check: don&#39;t check it. }</span></div>
<div class="line"><a id="l02246" name="l02246"></a><span class="lineno"> 2246</span><span class="comment">   * else if (m_dynamic_values_set) { As advertised do not check defaults except possibly before first load. } */</span></div>
<div class="line"><a id="l02247" name="l02247"></a><span class="lineno"> 2247</span> </div>
<div class="line"><a id="l02248" name="l02248"></a><span class="lineno"> 2248</span>  <span class="comment">/* Do the actual parsing of each dynamic Option_set.  Recall that due to forward/backward-compatibility concerns</span></div>
<div class="line"><a id="l02249" name="l02249"></a><span class="lineno"> 2249</span><span class="comment">   * we allow any unknown option names, hence the empty set for all_opt_names. */</span></div>
<div class="line"><a id="l02250" name="l02250"></a><span class="lineno"> 2250</span>  success = success</div>
<div class="line"><a id="l02251" name="l02251"></a><span class="lineno"> 2251</span>              &amp;&amp; apply_static_or_dynamic_impl&lt;Value_set...&gt;(<span class="keyword">true</span>,</div>
<div class="line"><a id="l02252" name="l02252"></a><span class="lineno"> 2252</span>                                                            dynamic_cfg_path, {}, final_validator_func...);</div>
<div class="line"><a id="l02253" name="l02253"></a><span class="lineno"> 2253</span> </div>
<div class="line"><a id="l02254" name="l02254"></a><span class="lineno"> 2254</span>  <span class="keywordflow">if</span> ((!commit) &amp;&amp; success)</div>
<div class="line"><a id="l02255" name="l02255"></a><span class="lineno"> 2255</span>  {</div>
<div class="line"><a id="l02256" name="l02256"></a><span class="lineno"> 2256</span>    m_multi_src_update_in_progress = Update_type::S_DYNAMIC; <span class="comment">// (Was either NONE or already this.)</span></div>
<div class="line"><a id="l02257" name="l02257"></a><span class="lineno"> 2257</span>    <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Multi-source update has successfully begun or continued.  &quot;</span></div>
<div class="line"><a id="l02258" name="l02258"></a><span class="lineno"> 2258</span>                  <span class="stringliteral">&quot;Expecting more sources before we can canonicalize candidate(s).&quot;</span>);</div>
<div class="line"><a id="l02259" name="l02259"></a><span class="lineno"> 2259</span>    <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a id="l02260" name="l02260"></a><span class="lineno"> 2260</span>  }</div>
<div class="line"><a id="l02261" name="l02261"></a><span class="lineno"> 2261</span>  <span class="comment">// else if (commit || (!success))</span></div>
<div class="line"><a id="l02262" name="l02262"></a><span class="lineno"> 2262</span> </div>
<div class="line"><a id="l02263" name="l02263"></a><span class="lineno"> 2263</span>  <span class="comment">/* !success =&gt; reject, regardless of commit (a failure aborts a multi-source update too).</span></div>
<div class="line"><a id="l02264" name="l02264"></a><span class="lineno"> 2264</span><span class="comment">   * commit =&gt; accept or reject depending on `success`.</span></div>
<div class="line"><a id="l02265" name="l02265"></a><span class="lineno"> 2265</span><span class="comment">   *</span></div>
<div class="line"><a id="l02266" name="l02266"></a><span class="lineno"> 2266</span><span class="comment">   * So next either canonicalize or reject each parse attempt depending on overall success (dynamic only). */</span></div>
<div class="line"><a id="l02267" name="l02267"></a><span class="lineno"> 2267</span>  <span class="keywordtype">size_t</span> d_value_set_idx = 0;</div>
<div class="line"><a id="l02268" name="l02268"></a><span class="lineno"> 2268</span> </div>
<div class="line"><a id="l02269" name="l02269"></a><span class="lineno"> 2269</span>  <span class="comment">/* Zero it (`{}`) to avoid warnings from undefined behavior sanitizer; it’s not a perf-critical path.</span></div>
<div class="line"><a id="l02270" name="l02270"></a><span class="lineno"> 2270</span><span class="comment">   * (In reality the zeroing is not necessary, but we&#39;ve run into warnings by some tools; might as well avoid.) */</span></div>
<div class="line"><a id="l02271" name="l02271"></a><span class="lineno"> 2271</span>  array&lt;bool, S_N_D_VALUE_SETS&gt; changed{};</div>
<div class="line"><a id="l02272" name="l02272"></a><span class="lineno"> 2272</span>  <span class="keywordtype">bool</span> some_changed = <span class="keyword">false</span>;</div>
<div class="line"><a id="l02273" name="l02273"></a><span class="lineno"> 2273</span>  (</div>
<div class="line"><a id="l02274" name="l02274"></a><span class="lineno"> 2274</span>    ...,</div>
<div class="line"><a id="l02275" name="l02275"></a><span class="lineno"> 2275</span>    (</div>
<div class="line"><a id="l02276" name="l02276"></a><span class="lineno"> 2276</span>      value_set_idx = (d_value_set_idx * 2) + 1, <span class="comment">// 1, 3, 5, ....</span></div>
<div class="line"><a id="l02277" name="l02277"></a><span class="lineno"> 2277</span>      <span class="comment">/* Note: If parsing stopped before `value_set_idx` due to failure, rejecting Option_set value_set_idx is a</span></div>
<div class="line"><a id="l02278" name="l02278"></a><span class="lineno"> 2278</span><span class="comment">       * harmless no-op by Option_set docs. */</span></div>
<div class="line"><a id="l02279" name="l02279"></a><span class="lineno"> 2279</span>      option_set_canonicalize_or_reject(opt_set&lt;Value_set&gt;(value_set_idx), <span class="comment">// Param pack expansion kernel here.</span></div>
<div class="line"><a id="l02280" name="l02280"></a><span class="lineno"> 2280</span>                                        success,</div>
<div class="line"><a id="l02281" name="l02281"></a><span class="lineno"> 2281</span>                                        <span class="comment">// If initial dynamic parse, then `changed[] = true` by definition.</span></div>
<div class="line"><a id="l02282" name="l02282"></a><span class="lineno"> 2282</span>                                        m_dynamic_values_set ? &amp;changed[d_value_set_idx] : 0),</div>
<div class="line"><a id="l02283" name="l02283"></a><span class="lineno"> 2283</span>      <span class="comment">// If initial dynamic parse, then `changed[] = true` by definition.</span></div>
<div class="line"><a id="l02284" name="l02284"></a><span class="lineno"> 2284</span>      changed[d_value_set_idx] = (!m_dynamic_values_set) || changed[d_value_set_idx],</div>
<div class="line"><a id="l02285" name="l02285"></a><span class="lineno"> 2285</span>      <span class="comment">// some_changed = true iff: changed[x] == true for at least one x.</span></div>
<div class="line"><a id="l02286" name="l02286"></a><span class="lineno"> 2286</span>      some_changed = some_changed || changed[d_value_set_idx],</div>
<div class="line"><a id="l02287" name="l02287"></a><span class="lineno"> 2287</span>      ++d_value_set_idx</div>
<div class="line"><a id="l02288" name="l02288"></a><span class="lineno"> 2288</span>    )</div>
<div class="line"><a id="l02289" name="l02289"></a><span class="lineno"> 2289</span>  );</div>
<div class="line"><a id="l02290" name="l02290"></a><span class="lineno"> 2290</span> </div>
<div class="line"><a id="l02291" name="l02291"></a><span class="lineno"> 2291</span>  <span class="keywordflow">if</span> (m_multi_src_update_in_progress != Update_type::S_NONE)</div>
<div class="line"><a id="l02292" name="l02292"></a><span class="lineno"> 2292</span>  {</div>
<div class="line"><a id="l02293" name="l02293"></a><span class="lineno"> 2293</span>    <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Multi-source update is now finished.&quot;</span>);</div>
<div class="line"><a id="l02294" name="l02294"></a><span class="lineno"> 2294</span>    m_multi_src_update_in_progress = Update_type::S_NONE;</div>
<div class="line"><a id="l02295" name="l02295"></a><span class="lineno"> 2295</span>  }</div>
<div class="line"><a id="l02296" name="l02296"></a><span class="lineno"> 2296</span>  <span class="comment">// else { It was NONE and remains so, either due to failure or being a vanilla (single-source) update or both. }</span></div>
<div class="line"><a id="l02297" name="l02297"></a><span class="lineno"> 2297</span> </div>
<div class="line"><a id="l02298" name="l02298"></a><span class="lineno"> 2298</span>  <span class="keywordflow">if</span> (!success)</div>
<div class="line"><a id="l02299" name="l02299"></a><span class="lineno"> 2299</span>  {</div>
<div class="line"><a id="l02300" name="l02300"></a><span class="lineno"> 2300</span>    <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a id="l02301" name="l02301"></a><span class="lineno"> 2301</span>  }</div>
<div class="line"><a id="l02302" name="l02302"></a><span class="lineno"> 2302</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l02303" name="l02303"></a><span class="lineno"> 2303</span> </div>
<div class="line"><a id="l02304" name="l02304"></a><span class="lineno"> 2304</span>  <span class="keywordflow">if</span> (!some_changed) <span class="comment">// Note, again, that if initial dynamic parse then some_changed==true.</span></div>
<div class="line"><a id="l02305" name="l02305"></a><span class="lineno"> 2305</span>  {</div>
<div class="line"><a id="l02306" name="l02306"></a><span class="lineno"> 2306</span>    <span class="keywordflow">return</span> <span class="keyword">true</span>; <span class="comment">// Meaning, no changes -- but success.</span></div>
<div class="line"><a id="l02307" name="l02307"></a><span class="lineno"> 2307</span>  }</div>
<div class="line"><a id="l02308" name="l02308"></a><span class="lineno"> 2308</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l02309" name="l02309"></a><span class="lineno"> 2309</span> </div>
<div class="line"><a id="l02310" name="l02310"></a><span class="lineno"> 2310</span>  <span class="comment">// The following is almost exactly log_state() but for dynamic sets only.</span></div>
<div class="line"><a id="l02311" name="l02311"></a><span class="lineno"> 2311</span>  String_ostream os;</div>
<div class="line"><a id="l02312" name="l02312"></a><span class="lineno"> 2312</span>  os.os() &lt;&lt; <span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: (Dynamic) state that was just made canonical follows.\n&quot;</span>;</div>
<div class="line"><a id="l02313" name="l02313"></a><span class="lineno"> 2313</span>  value_set_idx = 1;</div>
<div class="line"><a id="l02314" name="l02314"></a><span class="lineno"> 2314</span>  (</div>
<div class="line"><a id="l02315" name="l02315"></a><span class="lineno"> 2315</span>    ...,</div>
<div class="line"><a id="l02316" name="l02316"></a><span class="lineno"> 2316</span>    (</div>
<div class="line"><a id="l02317" name="l02317"></a><span class="lineno"> 2317</span>      <span class="comment">// 1, 3, 5, ....</span></div>
<div class="line"><a id="l02318" name="l02318"></a><span class="lineno"> 2318</span>      state_to_ostream_impl&lt;Value_set&gt;(value_set_idx, os.os()), <span class="comment">// Param pack expansion kernel here.</span></div>
<div class="line"><a id="l02319" name="l02319"></a><span class="lineno"> 2319</span>      value_set_idx += 2</div>
<div class="line"><a id="l02320" name="l02320"></a><span class="lineno"> 2320</span>    )</div>
<div class="line"><a id="l02321" name="l02321"></a><span class="lineno"> 2321</span>  );</div>
<div class="line"><a id="l02322" name="l02322"></a><span class="lineno"> 2322</span>  os.os() &lt;&lt; flush;</div>
<div class="line"><a id="l02323" name="l02323"></a><span class="lineno"> 2323</span>  <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(os.str());</div>
<div class="line"><a id="l02324" name="l02324"></a><span class="lineno"> 2324</span> </div>
<div class="line"><a id="l02325" name="l02325"></a><span class="lineno"> 2325</span>  <span class="comment">/* Next: Eureka!  Set the dynamic-values pointer for each option set that did change.</span></div>
<div class="line"><a id="l02326" name="l02326"></a><span class="lineno"> 2326</span><span class="comment">   *</span></div>
<div class="line"><a id="l02327" name="l02327"></a><span class="lineno"> 2327</span><span class="comment">   * There are some funky-looking logic-op/comma-expr constructions in there.  I (ygoldfel) feel they&#39;re understandable</span></div>
<div class="line"><a id="l02328" name="l02328"></a><span class="lineno"> 2328</span><span class="comment">   * enough, and the conciseness is worth it, but arguably it could instead be done with regular `if ()`s instead</span></div>
<div class="line"><a id="l02329" name="l02329"></a><span class="lineno"> 2329</span><span class="comment">   * in a helper function -- though less concise (possible @todo).  BTW generic lambdas could help there, but it would</span></div>
<div class="line"><a id="l02330" name="l02330"></a><span class="lineno"> 2330</span><span class="comment">   * require C++20 (I haven&#39;t looked into it thoroughly though). */</span></div>
<div class="line"><a id="l02331" name="l02331"></a><span class="lineno"> 2331</span>  {</div>
<div class="line"><a id="l02332" name="l02332"></a><span class="lineno"> 2332</span>    <a class="code hl_typedef" href="namespaceflow_1_1util.html#a5d2247b715da63e4b960909561b90ae7">Lock_guard</a>&lt;<span class="keyword">decltype</span>(m_d_value_sets_mutex)&gt; lock(m_d_value_sets_mutex);</div>
<div class="line"><a id="l02333" name="l02333"></a><span class="lineno"> 2333</span>    d_value_set_idx = 0;</div>
<div class="line"><a id="l02334" name="l02334"></a><span class="lineno"> 2334</span>    (</div>
<div class="line"><a id="l02335" name="l02335"></a><span class="lineno"> 2335</span>      ...,</div>
<div class="line"><a id="l02336" name="l02336"></a><span class="lineno"> 2336</span>      (</div>
<div class="line"><a id="l02337" name="l02337"></a><span class="lineno"> 2337</span>        value_set_idx = (d_value_set_idx * 2) + 1, <span class="comment">// 1, 3, 5, ....</span></div>
<div class="line"><a id="l02338" name="l02338"></a><span class="lineno"> 2338</span>        <span class="comment">// Just skip unchanged ones.  (This is `if (x) { f(...); }` in expression form.)</span></div>
<div class="line"><a id="l02339" name="l02339"></a><span class="lineno"> 2339</span>        changed[d_value_set_idx]</div>
<div class="line"><a id="l02340" name="l02340"></a><span class="lineno"> 2340</span>          &amp;&amp; (save_dynamic_value_set_locked&lt;Value_set&gt; <span class="comment">// Param pack expansion kernel here.</span></div>
<div class="line"><a id="l02341" name="l02341"></a><span class="lineno"> 2341</span>                (opt_set&lt;Value_set&gt;(value_set_idx), <span class="comment">// (And here.)</span></div>
<div class="line"><a id="l02342" name="l02342"></a><span class="lineno"> 2342</span>                 d_value_set_idx),</div>
<div class="line"><a id="l02343" name="l02343"></a><span class="lineno"> 2343</span>              <span class="keyword">true</span>),</div>
<div class="line"><a id="l02344" name="l02344"></a><span class="lineno"> 2344</span>        ++d_value_set_idx</div>
<div class="line"><a id="l02345" name="l02345"></a><span class="lineno"> 2345</span>      )</div>
<div class="line"><a id="l02346" name="l02346"></a><span class="lineno"> 2346</span>    );</div>
<div class="line"><a id="l02347" name="l02347"></a><span class="lineno"> 2347</span>  } <span class="comment">// Lock_guard lock(m_d_value_sets_mutex);</span></div>
<div class="line"><a id="l02348" name="l02348"></a><span class="lineno"> 2348</span> </div>
<div class="line"><a id="l02349" name="l02349"></a><span class="lineno"> 2349</span>  <span class="keyword">const</span> <span class="keywordtype">bool</span> was_dynamic_values_set = m_dynamic_values_set;</div>
<div class="line"><a id="l02350" name="l02350"></a><span class="lineno"> 2350</span>  m_dynamic_values_set = <span class="keyword">true</span>; <span class="comment">// Might already be true (if not initial parse).</span></div>
<div class="line"><a id="l02351" name="l02351"></a><span class="lineno"> 2351</span> </div>
<div class="line"><a id="l02352" name="l02352"></a><span class="lineno"> 2352</span>  <span class="comment">/* Finally invoke dynamic change (or &quot;change,&quot; if initial parse) listeners (possibly for the first time).</span></div>
<div class="line"><a id="l02353" name="l02353"></a><span class="lineno"> 2353</span><span class="comment">   * (.null() =&gt; no listeners registered.) */</span></div>
<div class="line"><a id="l02354" name="l02354"></a><span class="lineno"> 2354</span>  <span class="keywordflow">for</span> (d_value_set_idx = 0; d_value_set_idx != S_N_D_VALUE_SETS; ++d_value_set_idx)</div>
<div class="line"><a id="l02355" name="l02355"></a><span class="lineno"> 2355</span>  {</div>
<div class="line"><a id="l02356" name="l02356"></a><span class="lineno"> 2356</span>    <span class="keywordflow">if</span> (changed[d_value_set_idx])</div>
<div class="line"><a id="l02357" name="l02357"></a><span class="lineno"> 2357</span>    {</div>
<div class="line"><a id="l02358" name="l02358"></a><span class="lineno"> 2358</span>      invoke_dynamic_change_listeners(d_value_set_idx, !was_dynamic_values_set);</div>
<div class="line"><a id="l02359" name="l02359"></a><span class="lineno"> 2359</span>    }</div>
<div class="line"><a id="l02360" name="l02360"></a><span class="lineno"> 2360</span>  }</div>
<div class="line"><a id="l02361" name="l02361"></a><span class="lineno"> 2361</span> </div>
<div class="line"><a id="l02362" name="l02362"></a><span class="lineno"> 2362</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a id="l02363" name="l02363"></a><span class="lineno"> 2363</span>} <span class="comment">// Config_manager::apply_dynamic()</span></div>
<div class="line"><a id="l02364" name="l02364"></a><span class="lineno"> 2364</span> </div>
<div class="line"><a id="l02365" name="l02365"></a><span class="lineno"> 2365</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02366" name="l02366"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#ac1ab5cefe86e6aaa0518d675f309907e"> 2366</a></span><span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#ac1ab5cefe86e6aaa0518d675f309907e">Config_manager&lt;S_d_value_set...&gt;::reject_candidates</a>()</div>
<div class="line"><a id="l02367" name="l02367"></a><span class="lineno"> 2367</span>{</div>
<div class="line"><a id="l02368" name="l02368"></a><span class="lineno"> 2368</span>  <span class="keywordflow">if</span> (m_multi_src_update_in_progress == Update_type::S_NONE)</div>
<div class="line"><a id="l02369" name="l02369"></a><span class="lineno"> 2369</span>  {</div>
<div class="line"><a id="l02370" name="l02370"></a><span class="lineno"> 2370</span>    <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Request to abandon multi-source update in-progress; but none &quot;</span></div>
<div class="line"><a id="l02371" name="l02371"></a><span class="lineno"> 2371</span>                  <span class="stringliteral">&quot;is in progress.  Doing nothing.&quot;</span>);</div>
<div class="line"><a id="l02372" name="l02372"></a><span class="lineno"> 2372</span>    <span class="keywordflow">return</span>; <span class="comment">// Nothing to cancel.</span></div>
<div class="line"><a id="l02373" name="l02373"></a><span class="lineno"> 2373</span>  }</div>
<div class="line"><a id="l02374" name="l02374"></a><span class="lineno"> 2374</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l02375" name="l02375"></a><span class="lineno"> 2375</span> </div>
<div class="line"><a id="l02376" name="l02376"></a><span class="lineno"> 2376</span>  <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Request to abandon multi-source update in-progress.  Doing so.&quot;</span>);</div>
<div class="line"><a id="l02377" name="l02377"></a><span class="lineno"> 2377</span> </div>
<div class="line"><a id="l02378" name="l02378"></a><span class="lineno"> 2378</span>  <span class="comment">// (See class doc header Implementation section for explanation of fold-expression (..., ) trick.)</span></div>
<div class="line"><a id="l02379" name="l02379"></a><span class="lineno"> 2379</span>  <span class="keywordtype">size_t</span> value_set_idx = 0;</div>
<div class="line"><a id="l02380" name="l02380"></a><span class="lineno"> 2380</span>  (</div>
<div class="line"><a id="l02381" name="l02381"></a><span class="lineno"> 2381</span>    ...,</div>
<div class="line"><a id="l02382" name="l02382"></a><span class="lineno"> 2382</span>    (</div>
<div class="line"><a id="l02383" name="l02383"></a><span class="lineno"> 2383</span>      <span class="comment">/* This will be silent if it is a no-op for a given Value_set; namely if it&#39;s a Null_value_set, and/or</span></div>
<div class="line"><a id="l02384" name="l02384"></a><span class="lineno"> 2384</span><span class="comment">       * it pertains to a static Value_set after an apply_dynamic() or dynamic after an apply_static(). */</span></div>
<div class="line"><a id="l02385" name="l02385"></a><span class="lineno"> 2385</span>      option_set_canonicalize_or_reject</div>
<div class="line"><a id="l02386" name="l02386"></a><span class="lineno"> 2386</span>        (opt_set&lt;S_d_value_set&gt;(value_set_idx), <span class="comment">// Param pack expansion kernel here.</span></div>
<div class="line"><a id="l02387" name="l02387"></a><span class="lineno"> 2387</span>         <span class="keyword">false</span>, 0), <span class="comment">// false &lt;= reject.</span></div>
<div class="line"><a id="l02388" name="l02388"></a><span class="lineno"> 2388</span>      ++value_set_idx</div>
<div class="line"><a id="l02389" name="l02389"></a><span class="lineno"> 2389</span>    )</div>
<div class="line"><a id="l02390" name="l02390"></a><span class="lineno"> 2390</span>  );</div>
<div class="line"><a id="l02391" name="l02391"></a><span class="lineno"> 2391</span> </div>
<div class="line"><a id="l02392" name="l02392"></a><span class="lineno"> 2392</span>  m_multi_src_update_in_progress = Update_type::S_NONE;</div>
<div class="line"><a id="l02393" name="l02393"></a><span class="lineno"> 2393</span>} <span class="comment">// Config_manager::reject_candidates()</span></div>
<div class="line"><a id="l02394" name="l02394"></a><span class="lineno"> 2394</span> </div>
<div class="line"><a id="l02395" name="l02395"></a><span class="lineno"> 2395</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02396" name="l02396"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#abe9d2c5d3a9747a26a4e6233a0f1feed"> 2396</a></span><span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#abe9d2c5d3a9747a26a4e6233a0f1feed">Config_manager&lt;S_d_value_set...&gt;::reject_candidates_if_update_type_changed</a>(<a class="code hl_enumeration" href="classflow_1_1cfg_1_1Config__manager.html#aa0d03f4dcf7be2c21023c4073ac68b85">Update_type</a> this_update_type)</div>
<div class="line"><a id="l02397" name="l02397"></a><span class="lineno"> 2397</span>{</div>
<div class="line"><a id="l02398" name="l02398"></a><span class="lineno"> 2398</span>  assert(this_update_type != Update_type::S_NONE);</div>
<div class="line"><a id="l02399" name="l02399"></a><span class="lineno"> 2399</span>  <span class="keywordflow">if</span> ((m_multi_src_update_in_progress == Update_type::S_NONE) <span class="comment">// Nothing to cancel; all is cool.</span></div>
<div class="line"><a id="l02400" name="l02400"></a><span class="lineno"> 2400</span>      || (m_multi_src_update_in_progress == this_update_type)) <span class="comment">// It&#39;s a multi-source update; all is cool.</span></div>
<div class="line"><a id="l02401" name="l02401"></a><span class="lineno"> 2401</span>  {</div>
<div class="line"><a id="l02402" name="l02402"></a><span class="lineno"> 2402</span>    <span class="keywordflow">return</span>; <span class="comment">// Nothing to cancel.</span></div>
<div class="line"><a id="l02403" name="l02403"></a><span class="lineno"> 2403</span>  }</div>
<div class="line"><a id="l02404" name="l02404"></a><span class="lineno"> 2404</span>  <span class="comment">// else if (m_multi_src_update_in_progress is truthy but != this_update_type)</span></div>
<div class="line"><a id="l02405" name="l02405"></a><span class="lineno"> 2405</span> </div>
<div class="line"><a id="l02406" name="l02406"></a><span class="lineno"> 2406</span>  <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: An update of type [&quot;</span> &lt;&lt; <span class="keywordtype">int</span>(this_update_type) &lt;&lt; <span class="stringliteral">&quot;] &quot;</span></div>
<div class="line"><a id="l02407" name="l02407"></a><span class="lineno"> 2407</span>                <span class="stringliteral">&quot;is interrupting (canceling) an in-progress multi-source update of type &quot;</span></div>
<div class="line"><a id="l02408" name="l02408"></a><span class="lineno"> 2408</span>                <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; <span class="keywordtype">int</span>(m_multi_src_update_in_progress) &lt;&lt; <span class="stringliteral">&quot;].  Reverting any uncommitted values &quot;</span></div>
<div class="line"><a id="l02409" name="l02409"></a><span class="lineno"> 2409</span>                <span class="stringliteral">&quot;from the latter.  Suggest invoking reject_candidates() explicitly if intentional; this &quot;</span></div>
<div class="line"><a id="l02410" name="l02410"></a><span class="lineno"> 2410</span>                <span class="stringliteral">&quot;message will then go away, while the code will be more deliberate.&quot;</span>);</div>
<div class="line"><a id="l02411" name="l02411"></a><span class="lineno"> 2411</span> </div>
<div class="line"><a id="l02412" name="l02412"></a><span class="lineno"> 2412</span>  reject_candidates();</div>
<div class="line"><a id="l02413" name="l02413"></a><span class="lineno"> 2413</span>  assert(m_multi_src_update_in_progress == Update_type::S_NONE);</div>
<div class="line"><a id="l02414" name="l02414"></a><span class="lineno"> 2414</span>} <span class="comment">// Config_manager::reject_candidates_if_update_type_changed()</span></div>
<div class="line"><a id="l02415" name="l02415"></a><span class="lineno"> 2415</span> </div>
<div class="line"><a id="l02416" name="l02416"></a><span class="lineno"> 2416</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02417" name="l02417"></a><span class="lineno"> 2417</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l02418" name="l02418"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a859a36cccd8196d9648f67de8656360a"> 2418</a></span><span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a859a36cccd8196d9648f67de8656360a">Config_manager&lt;S_d_value_set...&gt;::save_dynamic_value_set_locked</a></div>
<div class="line"><a id="l02419" name="l02419"></a><span class="lineno"> 2419</span>       (<a class="code hl_class" href="classflow_1_1cfg_1_1Option__set.html">Option_set&lt;Value_set&gt;</a>* opt_set_ptr, <span class="keywordtype">size_t</span> d_value_set_idx)</div>
<div class="line"><a id="l02420" name="l02420"></a><span class="lineno"> 2420</span>{</div>
<div class="line"><a id="l02421" name="l02421"></a><span class="lineno"> 2421</span>  assert(opt_set_ptr);</div>
<div class="line"><a id="l02422" name="l02422"></a><span class="lineno"> 2422</span>  <span class="keyword">auto</span>&amp; opt_set = *opt_set_ptr;</div>
<div class="line"><a id="l02423" name="l02423"></a><span class="lineno"> 2423</span> </div>
<div class="line"><a id="l02424" name="l02424"></a><span class="lineno"> 2424</span>  <span class="comment">/* Make a copy of the canonical dynamic Value_set, wrapped in ptr-to-mutable; upgrade to ptr-to-immutable.</span></div>
<div class="line"><a id="l02425" name="l02425"></a><span class="lineno"> 2425</span><span class="comment">   * @todo It&#39;s not-great this is inside the locked section.  There&#39;s no great alternative -- maybe make all these</span></div>
<div class="line"><a id="l02426" name="l02426"></a><span class="lineno"> 2426</span><span class="comment">   * copies before the locked section, which can be done; it&#39;s just rather hairy due to the param-pack expanding. */</span></div>
<div class="line"><a id="l02427" name="l02427"></a><span class="lineno"> 2427</span>  *(<span class="keyword">static_cast&lt;</span>typename Value_set::Const_ptr*<span class="keyword">&gt;</span>(m_d_value_sets[d_value_set_idx].get()))</div>
<div class="line"><a id="l02428" name="l02428"></a><span class="lineno"> 2428</span>    <span class="comment">// Attn: --^ void* -&gt; T* cast; no RTTI to check our type safety.</span></div>
<div class="line"><a id="l02429" name="l02429"></a><span class="lineno"> 2429</span>    = Value_set::const_ptr_cast(opt_set.mutable_values_copy());</div>
<div class="line"><a id="l02430" name="l02430"></a><span class="lineno"> 2430</span>}</div>
<div class="line"><a id="l02431" name="l02431"></a><span class="lineno"> 2431</span> </div>
<div class="line"><a id="l02432" name="l02432"></a><span class="lineno"> 2432</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02433" name="l02433"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a57140907e43a66705625d391e85e3c52"> 2433</a></span><span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a57140907e43a66705625d391e85e3c52">Config_manager&lt;S_d_value_set...&gt;::invoke_dynamic_change_listeners</a>(<span class="keywordtype">size_t</span> d_value_set_idx, <span class="keywordtype">bool</span> init)<span class="keyword"> const</span></div>
<div class="line"><a id="l02434" name="l02434"></a><span class="lineno"> 2434</span><span class="keyword"></span>{</div>
<div class="line"><a id="l02435" name="l02435"></a><span class="lineno"> 2435</span>  <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: &quot;</span></div>
<div class="line"><a id="l02436" name="l02436"></a><span class="lineno"> 2436</span>                <span class="stringliteral">&quot;Dynamic update for dynamic option set [&quot;</span> &lt;&lt; d_value_set_idx &lt;&lt; <span class="stringliteral">&quot;] (0-based) of &quot;</span></div>
<div class="line"><a id="l02437" name="l02437"></a><span class="lineno"> 2437</span>                <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; S_N_D_VALUE_SETS &lt;&lt; <span class="stringliteral">&quot;] (1-based); trigger was &quot;</span></div>
<div class="line"><a id="l02438" name="l02438"></a><span class="lineno"> 2438</span>                <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; (init ? <span class="stringliteral">&quot;initial-update&quot;</span> : <span class="stringliteral">&quot;change-detected&quot;</span>) &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l02439" name="l02439"></a><span class="lineno"> 2439</span> </div>
<div class="line"><a id="l02440" name="l02440"></a><span class="lineno"> 2440</span>  <span class="keyword">const</span> <span class="keyword">auto</span>&amp; on_dynamic_change_funcs = m_on_dynamic_change_funcs[d_value_set_idx];</div>
<div class="line"><a id="l02441" name="l02441"></a><span class="lineno"> 2441</span> </div>
<div class="line"><a id="l02442" name="l02442"></a><span class="lineno"> 2442</span>  <span class="keywordtype">size_t</span> idx = 0;</div>
<div class="line"><a id="l02443" name="l02443"></a><span class="lineno"> 2443</span>  <span class="keywordflow">for</span> (<span class="keyword">const</span> <span class="keyword">auto</span>&amp; on_dynamic_change_func : on_dynamic_change_funcs)</div>
<div class="line"><a id="l02444" name="l02444"></a><span class="lineno"> 2444</span>  {</div>
<div class="line"><a id="l02445" name="l02445"></a><span class="lineno"> 2445</span>    <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Invoking listener [&quot;</span> &lt;&lt; idx &lt;&lt; <span class="stringliteral">&quot;] (0-based) of [&quot;</span> &lt;&lt; on_dynamic_change_funcs.size() &lt;&lt; <span class="stringliteral">&quot;] &quot;</span></div>
<div class="line"><a id="l02446" name="l02446"></a><span class="lineno"> 2446</span>                  <span class="stringliteral">&quot;(1-based).&quot;</span>);</div>
<div class="line"><a id="l02447" name="l02447"></a><span class="lineno"> 2447</span>    on_dynamic_change_func();</div>
<div class="line"><a id="l02448" name="l02448"></a><span class="lineno"> 2448</span>    ++idx;</div>
<div class="line"><a id="l02449" name="l02449"></a><span class="lineno"> 2449</span>  }</div>
<div class="line"><a id="l02450" name="l02450"></a><span class="lineno"> 2450</span>  <a class="code hl_define" href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a>(<span class="stringliteral">&quot;Done invoking change listeners for dynamic option set.&quot;</span>);</div>
<div class="line"><a id="l02451" name="l02451"></a><span class="lineno"> 2451</span>} <span class="comment">// Config_manager::invoke_dynamic_change_listeners()</span></div>
<div class="line"><a id="l02452" name="l02452"></a><span class="lineno"> 2452</span> </div>
<div class="line"><a id="l02453" name="l02453"></a><span class="lineno"> 2453</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02454" name="l02454"></a><span class="lineno"> 2454</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l02455" name="l02455"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a76c7224711ef8a51c7005629e4eae6e7"> 2455</a></span><span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a76c7224711ef8a51c7005629e4eae6e7">Config_manager&lt;S_d_value_set...&gt;::all_static_values</a>(<span class="keyword">const</span> Value_set**... value_set_or_null)<span class="keyword"> const</span></div>
<div class="line"><a id="l02456" name="l02456"></a><span class="lineno"> 2456</span><span class="keyword"></span>{</div>
<div class="line"><a id="l02457" name="l02457"></a><span class="lineno"> 2457</span>  <span class="keyword">static_assert</span>(<span class="keyword">sizeof</span>...(Value_set) == S_N_S_VALUE_SETS,</div>
<div class="line"><a id="l02458" name="l02458"></a><span class="lineno"> 2458</span>                <span class="stringliteral">&quot;You must supply N/2 `value_set_or_null`s, where N is # of S_d_value_set params.  &quot;</span></div>
<div class="line"><a id="l02459" name="l02459"></a><span class="lineno"> 2459</span>                  <span class="stringliteral">&quot;Use nullptr for any Null_value_set and/or Value_set of no interest.&quot;</span>);</div>
<div class="line"><a id="l02460" name="l02460"></a><span class="lineno"> 2460</span> </div>
<div class="line"><a id="l02461" name="l02461"></a><span class="lineno"> 2461</span>  <span class="keywordtype">size_t</span> s_value_set_idx = 0;</div>
<div class="line"><a id="l02462" name="l02462"></a><span class="lineno"> 2462</span>  <span class="keywordtype">size_t</span> value_set_idx;</div>
<div class="line"><a id="l02463" name="l02463"></a><span class="lineno"> 2463</span>  (</div>
<div class="line"><a id="l02464" name="l02464"></a><span class="lineno"> 2464</span>    ...,</div>
<div class="line"><a id="l02465" name="l02465"></a><span class="lineno"> 2465</span>    (</div>
<div class="line"><a id="l02466" name="l02466"></a><span class="lineno"> 2466</span>      value_set_idx = s_value_set_idx * 2,</div>
<div class="line"><a id="l02467" name="l02467"></a><span class="lineno"> 2467</span>      <span class="comment">// I.e., if (x &amp;&amp; y) { *x = ... }.</span></div>
<div class="line"><a id="l02468" name="l02468"></a><span class="lineno"> 2468</span>      (value_set_or_null &amp;&amp; (!opt_set&lt;Value_set&gt; <span class="comment">// Param pack expansion kernel here (x2).</span></div>
<div class="line"><a id="l02469" name="l02469"></a><span class="lineno"> 2469</span>                                (value_set_idx)-&gt;null()))</div>
<div class="line"><a id="l02470" name="l02470"></a><span class="lineno"> 2470</span>        &amp;&amp; (*value_set_or_null = &amp;(opt_set&lt;Value_set&gt;(value_set_idx)-&gt;values()), <span class="comment">// (And here, x2.)</span></div>
<div class="line"><a id="l02471" name="l02471"></a><span class="lineno"> 2471</span>            <span class="keyword">true</span>),</div>
<div class="line"><a id="l02472" name="l02472"></a><span class="lineno"> 2472</span>      ++s_value_set_idx</div>
<div class="line"><a id="l02473" name="l02473"></a><span class="lineno"> 2473</span>    )</div>
<div class="line"><a id="l02474" name="l02474"></a><span class="lineno"> 2474</span>  );</div>
<div class="line"><a id="l02475" name="l02475"></a><span class="lineno"> 2475</span>} <span class="comment">// Config_manager::all_static_values()</span></div>
<div class="line"><a id="l02476" name="l02476"></a><span class="lineno"> 2476</span> </div>
<div class="line"><a id="l02477" name="l02477"></a><span class="lineno"> 2477</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02478" name="l02478"></a><span class="lineno"> 2478</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l02479" name="l02479"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a616c39cdf1c6f7f4d2af3a3055edf486"> 2479</a></span><span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a616c39cdf1c6f7f4d2af3a3055edf486">Config_manager&lt;S_d_value_set...&gt;::all_static_values_candidates</a>(<span class="keyword">const</span> Value_set**... value_set_or_null)<span class="keyword"> const</span></div>
<div class="line"><a id="l02480" name="l02480"></a><span class="lineno"> 2480</span><span class="keyword"></span>{</div>
<div class="line"><a id="l02481" name="l02481"></a><span class="lineno"> 2481</span>  <span class="keyword">static_assert</span>(<span class="keyword">sizeof</span>...(Value_set) == S_N_S_VALUE_SETS,</div>
<div class="line"><a id="l02482" name="l02482"></a><span class="lineno"> 2482</span>                <span class="stringliteral">&quot;You must supply N/2 `value_set_or_null`s, where N is # of S_d_value_set params.  &quot;</span></div>
<div class="line"><a id="l02483" name="l02483"></a><span class="lineno"> 2483</span>                  <span class="stringliteral">&quot;Use nullptr for any Null_value_set and/or Value_set of no interest.&quot;</span>);</div>
<div class="line"><a id="l02484" name="l02484"></a><span class="lineno"> 2484</span> </div>
<div class="line"><a id="l02485" name="l02485"></a><span class="lineno"> 2485</span>  <span class="keywordtype">size_t</span> s_value_set_idx = 0;</div>
<div class="line"><a id="l02486" name="l02486"></a><span class="lineno"> 2486</span>  <span class="keywordtype">size_t</span> value_set_idx;</div>
<div class="line"><a id="l02487" name="l02487"></a><span class="lineno"> 2487</span>  (</div>
<div class="line"><a id="l02488" name="l02488"></a><span class="lineno"> 2488</span>    ...,</div>
<div class="line"><a id="l02489" name="l02489"></a><span class="lineno"> 2489</span>    (</div>
<div class="line"><a id="l02490" name="l02490"></a><span class="lineno"> 2490</span>      value_set_idx = s_value_set_idx * 2,</div>
<div class="line"><a id="l02491" name="l02491"></a><span class="lineno"> 2491</span>      (value_set_or_null &amp;&amp; (!opt_set&lt;Value_set&gt; <span class="comment">// Param pack expansion kernel here (x2).</span></div>
<div class="line"><a id="l02492" name="l02492"></a><span class="lineno"> 2492</span>                                (value_set_idx)-&gt;null()))</div>
<div class="line"><a id="l02493" name="l02493"></a><span class="lineno"> 2493</span>        <span class="comment">/* Emitted pointer will be equivalent to what is provided by all_static_values() unless a</span></div>
<div class="line"><a id="l02494" name="l02494"></a><span class="lineno"> 2494</span><span class="comment">         * parsed-but-not-canonicalized value set is available (i.e. this is being called from a validator function</span></div>
<div class="line"><a id="l02495" name="l02495"></a><span class="lineno"> 2495</span><span class="comment">         * being executed during parsing).  This is achieved here because Option_set&lt;&gt;::values_candidate() will return</span></div>
<div class="line"><a id="l02496" name="l02496"></a><span class="lineno"> 2496</span><span class="comment">         * the candidate when in PARSING state, but nullptr when in CANONICAL state (in which case the canonical values</span></div>
<div class="line"><a id="l02497" name="l02497"></a><span class="lineno"> 2497</span><span class="comment">         * provided by Option_set&lt;&gt;::values() is then used, here, instead). */</span></div>
<div class="line"><a id="l02498" name="l02498"></a><span class="lineno"> 2498</span>        &amp;&amp; (*value_set_or_null = opt_set&lt;Value_set&gt;(value_set_idx)-&gt;values_candidate() <span class="comment">// (And here x2.)</span></div>
<div class="line"><a id="l02499" name="l02499"></a><span class="lineno"> 2499</span>                                   <span class="comment">// (?: with omitted middle operand is gcc extension).</span></div>
<div class="line"><a id="l02500" name="l02500"></a><span class="lineno"> 2500</span>                                   ?: &amp;(opt_set&lt;Value_set&gt;(value_set_idx)-&gt;values()), <span class="comment">// (And here.)</span></div>
<div class="line"><a id="l02501" name="l02501"></a><span class="lineno"> 2501</span>            <span class="keyword">true</span>),</div>
<div class="line"><a id="l02502" name="l02502"></a><span class="lineno"> 2502</span>      ++s_value_set_idx</div>
<div class="line"><a id="l02503" name="l02503"></a><span class="lineno"> 2503</span>    )</div>
<div class="line"><a id="l02504" name="l02504"></a><span class="lineno"> 2504</span>  );</div>
<div class="line"><a id="l02505" name="l02505"></a><span class="lineno"> 2505</span>} <span class="comment">// Config_manager::all_static_values_candidates()</span></div>
<div class="line"><a id="l02506" name="l02506"></a><span class="lineno"> 2506</span> </div>
<div class="line"><a id="l02507" name="l02507"></a><span class="lineno"> 2507</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02508" name="l02508"></a><span class="lineno"> 2508</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l02509" name="l02509"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a8431806f82bed676f5fedb3b64f67245"> 2509</a></span><span class="keyword">const</span> Value_set&amp; <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a8431806f82bed676f5fedb3b64f67245">Config_manager&lt;S_d_value_set...&gt;::static_values</a>(<span class="keywordtype">size_t</span> s_value_set_idx)<span class="keyword"> const</span></div>
<div class="line"><a id="l02510" name="l02510"></a><span class="lineno"> 2510</span><span class="keyword"></span>{</div>
<div class="line"><a id="l02511" name="l02511"></a><span class="lineno"> 2511</span>  assert((s_value_set_idx &lt; S_N_S_VALUE_SETS) &amp;&amp; <span class="stringliteral">&quot;Invalid static option set index.&quot;</span>);</div>
<div class="line"><a id="l02512" name="l02512"></a><span class="lineno"> 2512</span> </div>
<div class="line"><a id="l02513" name="l02513"></a><span class="lineno"> 2513</span>  <span class="keywordflow">return</span> opt_set&lt;Value_set&gt;(s_value_set_idx * 2)-&gt;values();</div>
<div class="line"><a id="l02514" name="l02514"></a><span class="lineno"> 2514</span>} <span class="comment">// Config_manager::static_values()</span></div>
<div class="line"><a id="l02515" name="l02515"></a><span class="lineno"> 2515</span> </div>
<div class="line"><a id="l02516" name="l02516"></a><span class="lineno"> 2516</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02517" name="l02517"></a><span class="lineno"> 2517</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l02518" name="l02518"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#ae034a71792f952256c18e385475627d1"> 2518</a></span><span class="keyword">const</span> Value_set&amp; <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#ae034a71792f952256c18e385475627d1">Config_manager&lt;S_d_value_set...&gt;::static_values_candidate</a>(<span class="keywordtype">size_t</span> s_value_set_idx)<span class="keyword"> const</span></div>
<div class="line"><a id="l02519" name="l02519"></a><span class="lineno"> 2519</span><span class="keyword"></span>{</div>
<div class="line"><a id="l02520" name="l02520"></a><span class="lineno"> 2520</span>  assert((s_value_set_idx &lt; S_N_S_VALUE_SETS) &amp;&amp; <span class="stringliteral">&quot;Invalid static option set index.&quot;</span>);</div>
<div class="line"><a id="l02521" name="l02521"></a><span class="lineno"> 2521</span> </div>
<div class="line"><a id="l02522" name="l02522"></a><span class="lineno"> 2522</span>  <span class="keyword">const</span> <span class="keyword">auto</span> opt = opt_set&lt;Value_set&gt;(s_value_set_idx * 2);</div>
<div class="line"><a id="l02523" name="l02523"></a><span class="lineno"> 2523</span> </div>
<div class="line"><a id="l02524" name="l02524"></a><span class="lineno"> 2524</span>  <span class="comment">/* Return value will be equivalent to what is provided by static_values() unless a parsed-but-not-canonicalized value</span></div>
<div class="line"><a id="l02525" name="l02525"></a><span class="lineno"> 2525</span><span class="comment">   * set is available (i.e. this is being called from a validator function being executed during parsing).  This is</span></div>
<div class="line"><a id="l02526" name="l02526"></a><span class="lineno"> 2526</span><span class="comment">   * achieved here because -&gt;values_candidate() will return the candidate when in PARSING state, but nullptr when in</span></div>
<div class="line"><a id="l02527" name="l02527"></a><span class="lineno"> 2527</span><span class="comment">   * CANONICAL state (in which case the canonical values provided by -&gt;values() is used, instead). */</span></div>
<div class="line"><a id="l02528" name="l02528"></a><span class="lineno"> 2528</span>  <span class="keyword">const</span> Value_set* values = opt-&gt;values_candidate();</div>
<div class="line"><a id="l02529" name="l02529"></a><span class="lineno"> 2529</span>  <span class="keywordflow">if</span> (!values)</div>
<div class="line"><a id="l02530" name="l02530"></a><span class="lineno"> 2530</span>  {</div>
<div class="line"><a id="l02531" name="l02531"></a><span class="lineno"> 2531</span>    values = &amp;(opt-&gt;values());</div>
<div class="line"><a id="l02532" name="l02532"></a><span class="lineno"> 2532</span>  }</div>
<div class="line"><a id="l02533" name="l02533"></a><span class="lineno"> 2533</span> </div>
<div class="line"><a id="l02534" name="l02534"></a><span class="lineno"> 2534</span>  <span class="keywordflow">return</span> *values;</div>
<div class="line"><a id="l02535" name="l02535"></a><span class="lineno"> 2535</span>} <span class="comment">// Config_manager::static_values_candidate()</span></div>
<div class="line"><a id="l02536" name="l02536"></a><span class="lineno"> 2536</span> </div>
<div class="line"><a id="l02537" name="l02537"></a><span class="lineno"> 2537</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02538" name="l02538"></a><span class="lineno"> 2538</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... Value_set&gt;</div>
<div class="line"><a id="l02539" name="l02539"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a6afb8620600dcb54d41211ef68859f93"> 2539</a></span><span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a6afb8620600dcb54d41211ef68859f93">Config_manager&lt;S_d_value_set...&gt;::all_dynamic_values</a></div>
<div class="line"><a id="l02540" name="l02540"></a><span class="lineno"> 2540</span>       (<span class="keyword">typename</span> Value_set::Const_ptr*... value_set_or_null)<span class="keyword"> const</span></div>
<div class="line"><a id="l02541" name="l02541"></a><span class="lineno"> 2541</span><span class="keyword"></span>{</div>
<div class="line"><a id="l02542" name="l02542"></a><span class="lineno"> 2542</span>  <span class="keyword">using </span><a class="code hl_typedef" href="namespaceflow_1_1util.html#a5d2247b715da63e4b960909561b90ae7">util::Lock_guard</a>;</div>
<div class="line"><a id="l02543" name="l02543"></a><span class="lineno"> 2543</span> </div>
<div class="line"><a id="l02544" name="l02544"></a><span class="lineno"> 2544</span>  <span class="keyword">static_assert</span>(<span class="keyword">sizeof</span>...(Value_set) == S_N_D_VALUE_SETS,</div>
<div class="line"><a id="l02545" name="l02545"></a><span class="lineno"> 2545</span>                <span class="stringliteral">&quot;You must supply N/2 `value_set_or_null`s, where N is # of S_d_value_set params.  &quot;</span></div>
<div class="line"><a id="l02546" name="l02546"></a><span class="lineno"> 2546</span>                  <span class="stringliteral">&quot;Use nullptr for any Null_value_set and/or Value_set of no interest.&quot;</span>);</div>
<div class="line"><a id="l02547" name="l02547"></a><span class="lineno"> 2547</span> </div>
<div class="line"><a id="l02548" name="l02548"></a><span class="lineno"> 2548</span>  <span class="comment">// As promised just copy out the values atomically and return them.  Next time it might return different ones.</span></div>
<div class="line"><a id="l02549" name="l02549"></a><span class="lineno"> 2549</span>  <a class="code hl_typedef" href="namespaceflow_1_1util.html#a5d2247b715da63e4b960909561b90ae7">Lock_guard</a>&lt;<span class="keyword">decltype</span>(m_d_value_sets_mutex)&gt; lock(m_d_value_sets_mutex);</div>
<div class="line"><a id="l02550" name="l02550"></a><span class="lineno"> 2550</span> </div>
<div class="line"><a id="l02551" name="l02551"></a><span class="lineno"> 2551</span>  <span class="keywordtype">size_t</span> d_value_set_idx = 0;</div>
<div class="line"><a id="l02552" name="l02552"></a><span class="lineno"> 2552</span>  <span class="keywordtype">size_t</span> value_set_idx;</div>
<div class="line"><a id="l02553" name="l02553"></a><span class="lineno"> 2553</span>  (</div>
<div class="line"><a id="l02554" name="l02554"></a><span class="lineno"> 2554</span>    ...,</div>
<div class="line"><a id="l02555" name="l02555"></a><span class="lineno"> 2555</span>    (</div>
<div class="line"><a id="l02556" name="l02556"></a><span class="lineno"> 2556</span>      value_set_idx = (d_value_set_idx * 2) + 1,</div>
<div class="line"><a id="l02557" name="l02557"></a><span class="lineno"> 2557</span>      <span class="comment">// I.e., if (x &amp;&amp; y) { *x = ... }.</span></div>
<div class="line"><a id="l02558" name="l02558"></a><span class="lineno"> 2558</span>      (value_set_or_null &amp;&amp; (!opt_set&lt;Value_set&gt; <span class="comment">// Param pack expansion kernel here (x2).</span></div>
<div class="line"><a id="l02559" name="l02559"></a><span class="lineno"> 2559</span>                                (value_set_idx)-&gt;null()))</div>
<div class="line"><a id="l02560" name="l02560"></a><span class="lineno"> 2560</span>        &amp;&amp; (*value_set_or_null <span class="comment">// (And here.)</span></div>
<div class="line"><a id="l02561" name="l02561"></a><span class="lineno"> 2561</span>              = *(<span class="keyword">static_cast&lt;</span>typename Value_set::Const_ptr*<span class="keyword">&gt;</span>(m_d_value_sets[d_value_set_idx].get())), <span class="comment">// (And here.)</span></div>
<div class="line"><a id="l02562" name="l02562"></a><span class="lineno"> 2562</span>              <span class="comment">// Attn: --^ void* -&gt; T* cast; no RTTI to check our type safety.</span></div>
<div class="line"><a id="l02563" name="l02563"></a><span class="lineno"> 2563</span>            <span class="keyword">true</span>),</div>
<div class="line"><a id="l02564" name="l02564"></a><span class="lineno"> 2564</span>      ++d_value_set_idx</div>
<div class="line"><a id="l02565" name="l02565"></a><span class="lineno"> 2565</span>    )</div>
<div class="line"><a id="l02566" name="l02566"></a><span class="lineno"> 2566</span>  );</div>
<div class="line"><a id="l02567" name="l02567"></a><span class="lineno"> 2567</span>} <span class="comment">// Config_manager::all_dynamic_values()</span></div>
<div class="line"><a id="l02568" name="l02568"></a><span class="lineno"> 2568</span> </div>
<div class="line"><a id="l02569" name="l02569"></a><span class="lineno"> 2569</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02570" name="l02570"></a><span class="lineno"> 2570</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l02571" name="l02571"></a><span class="lineno"> 2571</span><span class="keyword">typename</span> Value_set::Const_ptr</div>
<div class="line"><a id="l02572" name="l02572"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#ac2239443cf48bfdaa78c95af935e1d0f"> 2572</a></span>  <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#ac2239443cf48bfdaa78c95af935e1d0f">Config_manager&lt;S_d_value_set...&gt;::dynamic_values</a>(<span class="keywordtype">size_t</span> d_value_set_idx)<span class="keyword"> const</span></div>
<div class="line"><a id="l02573" name="l02573"></a><span class="lineno"> 2573</span><span class="keyword"></span>{</div>
<div class="line"><a id="l02574" name="l02574"></a><span class="lineno"> 2574</span>  <span class="keyword">using </span><a class="code hl_typedef" href="namespaceflow_1_1util.html#a5d2247b715da63e4b960909561b90ae7">util::Lock_guard</a>;</div>
<div class="line"><a id="l02575" name="l02575"></a><span class="lineno"> 2575</span> </div>
<div class="line"><a id="l02576" name="l02576"></a><span class="lineno"> 2576</span>  assert((d_value_set_idx &lt; S_N_D_VALUE_SETS) &amp;&amp; <span class="stringliteral">&quot;Invalid dynamic option set index.&quot;</span>);</div>
<div class="line"><a id="l02577" name="l02577"></a><span class="lineno"> 2577</span> </div>
<div class="line"><a id="l02578" name="l02578"></a><span class="lineno"> 2578</span>  <span class="comment">// As promised just copy out the value atomically and return it.  Next time it might return different pointer.</span></div>
<div class="line"><a id="l02579" name="l02579"></a><span class="lineno"> 2579</span>  <a class="code hl_typedef" href="namespaceflow_1_1util.html#a5d2247b715da63e4b960909561b90ae7">Lock_guard</a>&lt;<span class="keyword">decltype</span>(m_d_value_sets_mutex)&gt; lock(m_d_value_sets_mutex);</div>
<div class="line"><a id="l02580" name="l02580"></a><span class="lineno"> 2580</span>  <span class="keywordflow">return</span> *(<span class="keyword">static_cast&lt;</span>typename Value_set::Const_ptr*<span class="keyword">&gt;</span>(m_d_value_sets[d_value_set_idx].get()));</div>
<div class="line"><a id="l02581" name="l02581"></a><span class="lineno"> 2581</span>  <span class="comment">// Attn: --^ void* -&gt; T* cast; no RTTI to check our type safety.</span></div>
<div class="line"><a id="l02582" name="l02582"></a><span class="lineno"> 2582</span>}</div>
<div class="line"><a id="l02583" name="l02583"></a><span class="lineno"> 2583</span> </div>
<div class="line"><a id="l02584" name="l02584"></a><span class="lineno"> 2584</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02585" name="l02585"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a19ae9775f51953805ea08086c276a78d"> 2585</a></span><span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a19ae9775f51953805ea08086c276a78d">Config_manager&lt;S_d_value_set...&gt;::state_to_ostream</a>(std::ostream&amp; os)<span class="keyword"> const</span></div>
<div class="line"><a id="l02586" name="l02586"></a><span class="lineno"> 2586</span><span class="keyword"></span>{</div>
<div class="line"><a id="l02587" name="l02587"></a><span class="lineno"> 2587</span>  os &lt;&lt; <span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Current state + config documentation:\n&quot;</span>;</div>
<div class="line"><a id="l02588" name="l02588"></a><span class="lineno"> 2588</span> </div>
<div class="line"><a id="l02589" name="l02589"></a><span class="lineno"> 2589</span>  <span class="keywordtype">size_t</span> value_set_idx = 0;</div>
<div class="line"><a id="l02590" name="l02590"></a><span class="lineno"> 2590</span>  (</div>
<div class="line"><a id="l02591" name="l02591"></a><span class="lineno"> 2591</span>    ...,</div>
<div class="line"><a id="l02592" name="l02592"></a><span class="lineno"> 2592</span>    state_to_ostream_impl&lt;S_d_value_set&gt;(value_set_idx++, os) <span class="comment">// Param pack expansion kernel here.</span></div>
<div class="line"><a id="l02593" name="l02593"></a><span class="lineno"> 2593</span>  );</div>
<div class="line"><a id="l02594" name="l02594"></a><span class="lineno"> 2594</span>}</div>
<div class="line"><a id="l02595" name="l02595"></a><span class="lineno"> 2595</span> </div>
<div class="line"><a id="l02596" name="l02596"></a><span class="lineno"> 2596</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02597" name="l02597"></a><span class="lineno"> 2597</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l02598" name="l02598"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#afbf1eca924be81654eaa4140814a816f"> 2598</a></span><span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#afbf1eca924be81654eaa4140814a816f">Config_manager&lt;S_d_value_set...&gt;::state_to_ostream_impl</a>(<span class="keywordtype">size_t</span> value_set_idx, std::ostream&amp; os)<span class="keyword"> const</span></div>
<div class="line"><a id="l02599" name="l02599"></a><span class="lineno"> 2599</span><span class="keyword"></span>{</div>
<div class="line"><a id="l02600" name="l02600"></a><span class="lineno"> 2600</span>  <span class="keyword">const</span> <span class="keyword">auto</span>&amp; opts = *(opt_set&lt;Value_set&gt;(value_set_idx));</div>
<div class="line"><a id="l02601" name="l02601"></a><span class="lineno"> 2601</span>  <span class="keywordflow">if</span> (opts.null())</div>
<div class="line"><a id="l02602" name="l02602"></a><span class="lineno"> 2602</span>  {</div>
<div class="line"><a id="l02603" name="l02603"></a><span class="lineno"> 2603</span>    <span class="keywordflow">return</span>; <span class="comment">// Print nothing at all.</span></div>
<div class="line"><a id="l02604" name="l02604"></a><span class="lineno"> 2604</span>  }</div>
<div class="line"><a id="l02605" name="l02605"></a><span class="lineno"> 2605</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l02606" name="l02606"></a><span class="lineno"> 2606</span> </div>
<div class="line"><a id="l02607" name="l02607"></a><span class="lineno"> 2607</span>  <span class="keyword">const</span> <span class="keywordtype">size_t</span> s_d_value_set_idx = value_set_idx / 2;</div>
<div class="line"><a id="l02608" name="l02608"></a><span class="lineno"> 2608</span>  <span class="keyword">const</span> <span class="keywordtype">bool</span> dyn_else_st = (value_set_idx % 2) == 1;</div>
<div class="line"><a id="l02609" name="l02609"></a><span class="lineno"> 2609</span> </div>
<div class="line"><a id="l02610" name="l02610"></a><span class="lineno"> 2610</span>  os &lt;&lt; <span class="stringliteral">&quot;-- [&quot;</span> &lt;&lt; (dyn_else_st ? <span class="stringliteral">&quot;DYNAMIC&quot;</span> : <span class="stringliteral">&quot;STATIC&quot;</span>) &lt;&lt; <span class="stringliteral">&quot;] [&quot;</span> &lt;&lt; s_d_value_set_idx &lt;&lt; <span class="stringliteral">&quot;] --\n&quot;</span>;</div>
<div class="line"><a id="l02611" name="l02611"></a><span class="lineno"> 2611</span> </div>
<div class="line"><a id="l02612" name="l02612"></a><span class="lineno"> 2612</span>  <span class="comment">/* Helper that prints any pending commit=false data that hasn&#39;t been upgraded to canonical via</span></div>
<div class="line"><a id="l02613" name="l02613"></a><span class="lineno"> 2613</span><span class="comment">   * apply_*(commit = true). */</span></div>
<div class="line"><a id="l02614" name="l02614"></a><span class="lineno"> 2614</span>  <span class="keyword">const</span> <span class="keyword">auto</span> output_uncanonicalized = [&amp;]()</div>
<div class="line"><a id="l02615" name="l02615"></a><span class="lineno"> 2615</span>  {</div>
<div class="line"><a id="l02616" name="l02616"></a><span class="lineno"> 2616</span>    <span class="keywordflow">if</span> (m_multi_src_update_in_progress != Update_type::S_NONE)</div>
<div class="line"><a id="l02617" name="l02617"></a><span class="lineno"> 2617</span>    {</div>
<div class="line"><a id="l02618" name="l02618"></a><span class="lineno"> 2618</span>      <span class="comment">/* The apply_*() sequence in-progress may be apply_dynamic(), while we&#39;re static, or vice versa.</span></div>
<div class="line"><a id="l02619" name="l02619"></a><span class="lineno"> 2619</span><span class="comment">       * In that case `Option_set opts` is in PARSING, not CANONICAL state, so there is nothing to print. */</span></div>
<div class="line"><a id="l02620" name="l02620"></a><span class="lineno"> 2620</span>      <span class="keyword">const</span> <span class="keyword">auto</span> candidate_or_none = opts.values_candidate();</div>
<div class="line"><a id="l02621" name="l02621"></a><span class="lineno"> 2621</span>      <span class="keywordflow">if</span> (candidate_or_none)</div>
<div class="line"><a id="l02622" name="l02622"></a><span class="lineno"> 2622</span>      {</div>
<div class="line"><a id="l02623" name="l02623"></a><span class="lineno"> 2623</span>        os &lt;&lt; <span class="stringliteral">&quot;  &lt;incomplete multi-source update type [&quot;</span> &lt;&lt; int(m_multi_src_update_in_progress) &lt;&lt; <span class="stringliteral">&quot;] in-progress / &quot;</span></div>
<div class="line"><a id="l02624" name="l02624"></a><span class="lineno"> 2624</span>              <span class="stringliteral">&quot;current candidate values follow&gt;\n&quot;</span>;</div>
<div class="line"><a id="l02625" name="l02625"></a><span class="lineno"> 2625</span>        opts.values_to_ostream(os, candidate_or_none);</div>
<div class="line"><a id="l02626" name="l02626"></a><span class="lineno"> 2626</span>      }</div>
<div class="line"><a id="l02627" name="l02627"></a><span class="lineno"> 2627</span>    }</div>
<div class="line"><a id="l02628" name="l02628"></a><span class="lineno"> 2628</span>  }; <span class="comment">// output_uncanonicalized =</span></div>
<div class="line"><a id="l02629" name="l02629"></a><span class="lineno"> 2629</span> </div>
<div class="line"><a id="l02630" name="l02630"></a><span class="lineno"> 2630</span>  <span class="keywordflow">if</span> (!dyn_else_st)</div>
<div class="line"><a id="l02631" name="l02631"></a><span class="lineno"> 2631</span>  {</div>
<div class="line"><a id="l02632" name="l02632"></a><span class="lineno"> 2632</span>    opts.values_to_ostream(os);</div>
<div class="line"><a id="l02633" name="l02633"></a><span class="lineno"> 2633</span>    output_uncanonicalized();</div>
<div class="line"><a id="l02634" name="l02634"></a><span class="lineno"> 2634</span>    <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l02635" name="l02635"></a><span class="lineno"> 2635</span>  }</div>
<div class="line"><a id="l02636" name="l02636"></a><span class="lineno"> 2636</span>  <span class="comment">// else if (dyn_else_st)</span></div>
<div class="line"><a id="l02637" name="l02637"></a><span class="lineno"> 2637</span> </div>
<div class="line"><a id="l02638" name="l02638"></a><span class="lineno"> 2638</span>  <span class="keywordflow">if</span> (m_dynamic_values_set)</div>
<div class="line"><a id="l02639" name="l02639"></a><span class="lineno"> 2639</span>  {</div>
<div class="line"><a id="l02640" name="l02640"></a><span class="lineno"> 2640</span>    opts.values_to_ostream(os);</div>
<div class="line"><a id="l02641" name="l02641"></a><span class="lineno"> 2641</span>    output_uncanonicalized();</div>
<div class="line"><a id="l02642" name="l02642"></a><span class="lineno"> 2642</span>    <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l02643" name="l02643"></a><span class="lineno"> 2643</span>  }</div>
<div class="line"><a id="l02644" name="l02644"></a><span class="lineno"> 2644</span>  <span class="comment">// else if (no dynamic values yet loaded)</span></div>
<div class="line"><a id="l02645" name="l02645"></a><span class="lineno"> 2645</span> </div>
<div class="line"><a id="l02646" name="l02646"></a><span class="lineno"> 2646</span>  <span class="comment">/* Print just help (no current values: we have none -- only defaults).</span></div>
<div class="line"><a id="l02647" name="l02647"></a><span class="lineno"> 2647</span><span class="comment">   * Granted the same could be said of static sets too, before apply_static*(), but keeping track of</span></div>
<div class="line"><a id="l02648" name="l02648"></a><span class="lineno"> 2648</span><span class="comment">   * a hypothetical m_static_values_set just to be able to do this same thing here for static options, for</span></div>
<div class="line"><a id="l02649" name="l02649"></a><span class="lineno"> 2649</span><span class="comment">   * something with such a simple usage lifecycle (apply_static*() is done exactly once, probably near the top</span></div>
<div class="line"><a id="l02650" name="l02650"></a><span class="lineno"> 2650</span><span class="comment">   * of the module/application), seems like overkill. */</span></div>
<div class="line"><a id="l02651" name="l02651"></a><span class="lineno"> 2651</span>  os &lt;&lt; <span class="stringliteral">&quot;&lt;no dynamic config init payload / option docs follow instead&gt;\n&quot;</span>;</div>
<div class="line"><a id="l02652" name="l02652"></a><span class="lineno"> 2652</span>  opts.help_to_ostream(os);</div>
<div class="line"><a id="l02653" name="l02653"></a><span class="lineno"> 2653</span> </div>
<div class="line"><a id="l02654" name="l02654"></a><span class="lineno"> 2654</span>  output_uncanonicalized();</div>
<div class="line"><a id="l02655" name="l02655"></a><span class="lineno"> 2655</span>} <span class="comment">// Config_manager::state_to_ostream_impl()</span></div>
<div class="line"><a id="l02656" name="l02656"></a><span class="lineno"> 2656</span> </div>
<div class="line"><a id="l02657" name="l02657"></a><span class="lineno"> 2657</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02658" name="l02658"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a220535219634c62ed2a580934c76c481"> 2658</a></span><span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a220535219634c62ed2a580934c76c481">Config_manager&lt;S_d_value_set...&gt;::log_state</a>(<a class="code hl_enumeration" href="namespaceflow_1_1log.html#a5c602384e6fe9d7642740ac2fae4ad04">log::Sev</a> sev)<span class="keyword"> const</span></div>
<div class="line"><a id="l02659" name="l02659"></a><span class="lineno"> 2659</span><span class="keyword"></span>{</div>
<div class="line"><a id="l02660" name="l02660"></a><span class="lineno"> 2660</span>  <span class="keyword">using </span><a class="code hl_class" href="classflow_1_1util_1_1String__ostream.html">util::String_ostream</a>;</div>
<div class="line"><a id="l02661" name="l02661"></a><span class="lineno"> 2661</span>  <span class="keyword">using </span>std::flush;</div>
<div class="line"><a id="l02662" name="l02662"></a><span class="lineno"> 2662</span> </div>
<div class="line"><a id="l02663" name="l02663"></a><span class="lineno"> 2663</span>  String_ostream os;</div>
<div class="line"><a id="l02664" name="l02664"></a><span class="lineno"> 2664</span>  state_to_ostream(os.os());</div>
<div class="line"><a id="l02665" name="l02665"></a><span class="lineno"> 2665</span>  os.os() &lt;&lt; flush;</div>
<div class="line"><a id="l02666" name="l02666"></a><span class="lineno"> 2666</span>  <a class="code hl_define" href="log_8hpp.html#a692bbadd8b5c3e9cef7a0bbea1915e66">FLOW_LOG_WITH_CHECKING</a>(sev, os.str());</div>
<div class="line"><a id="l02667" name="l02667"></a><span class="lineno"> 2667</span>} <span class="comment">// Config_manager::log_state()</span></div>
<div class="line"><a id="l02668" name="l02668"></a><span class="lineno"> 2668</span> </div>
<div class="line"><a id="l02669" name="l02669"></a><span class="lineno"> 2669</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02670" name="l02670"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#ad5cda6ace05e8bbe52a5129ed1c0720c"> 2670</a></span><span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#ad5cda6ace05e8bbe52a5129ed1c0720c">Config_manager&lt;S_d_value_set...&gt;::help_to_ostream</a>(std::ostream&amp; os)<span class="keyword"> const</span></div>
<div class="line"><a id="l02671" name="l02671"></a><span class="lineno"> 2671</span><span class="keyword"></span>{</div>
<div class="line"><a id="l02672" name="l02672"></a><span class="lineno"> 2672</span>  os &lt;&lt; <span class="stringliteral">&quot;Config_manager [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Config help:\n&quot;</span>;</div>
<div class="line"><a id="l02673" name="l02673"></a><span class="lineno"> 2673</span> </div>
<div class="line"><a id="l02674" name="l02674"></a><span class="lineno"> 2674</span>  <span class="keywordtype">size_t</span> value_set_idx = 0;</div>
<div class="line"><a id="l02675" name="l02675"></a><span class="lineno"> 2675</span>  (</div>
<div class="line"><a id="l02676" name="l02676"></a><span class="lineno"> 2676</span>    ...,</div>
<div class="line"><a id="l02677" name="l02677"></a><span class="lineno"> 2677</span>    help_to_ostream_impl&lt;S_d_value_set&gt;(value_set_idx++, os) <span class="comment">// Param pack expansion kernel here.</span></div>
<div class="line"><a id="l02678" name="l02678"></a><span class="lineno"> 2678</span>  );</div>
<div class="line"><a id="l02679" name="l02679"></a><span class="lineno"> 2679</span>}</div>
<div class="line"><a id="l02680" name="l02680"></a><span class="lineno"> 2680</span> </div>
<div class="line"><a id="l02681" name="l02681"></a><span class="lineno"> 2681</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02682" name="l02682"></a><span class="lineno"> 2682</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l02683" name="l02683"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a8be0e0697c1b106c7170795ee4a225e8"> 2683</a></span><span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a8be0e0697c1b106c7170795ee4a225e8">Config_manager&lt;S_d_value_set...&gt;::help_to_ostream_impl</a>(<span class="keywordtype">size_t</span> value_set_idx, std::ostream&amp; os)<span class="keyword"> const</span></div>
<div class="line"><a id="l02684" name="l02684"></a><span class="lineno"> 2684</span><span class="keyword"></span>{</div>
<div class="line"><a id="l02685" name="l02685"></a><span class="lineno"> 2685</span>  <span class="keyword">const</span> <span class="keyword">auto</span> opts = opt_set&lt;Value_set&gt;(value_set_idx);</div>
<div class="line"><a id="l02686" name="l02686"></a><span class="lineno"> 2686</span>  <span class="keywordflow">if</span> (opts-&gt;null())</div>
<div class="line"><a id="l02687" name="l02687"></a><span class="lineno"> 2687</span>  {</div>
<div class="line"><a id="l02688" name="l02688"></a><span class="lineno"> 2688</span>    <span class="keywordflow">return</span>; <span class="comment">// Print nothing at all.</span></div>
<div class="line"><a id="l02689" name="l02689"></a><span class="lineno"> 2689</span>  }</div>
<div class="line"><a id="l02690" name="l02690"></a><span class="lineno"> 2690</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l02691" name="l02691"></a><span class="lineno"> 2691</span> </div>
<div class="line"><a id="l02692" name="l02692"></a><span class="lineno"> 2692</span>  <span class="keyword">const</span> <span class="keywordtype">size_t</span> s_d_value_set_idx = value_set_idx / 2;</div>
<div class="line"><a id="l02693" name="l02693"></a><span class="lineno"> 2693</span>  <span class="keyword">const</span> <span class="keywordtype">bool</span> dyn_else_st = (value_set_idx % 2) == 1;</div>
<div class="line"><a id="l02694" name="l02694"></a><span class="lineno"> 2694</span> </div>
<div class="line"><a id="l02695" name="l02695"></a><span class="lineno"> 2695</span>  os &lt;&lt; <span class="stringliteral">&quot;-- [&quot;</span> &lt;&lt; (dyn_else_st ? <span class="stringliteral">&quot;DYNAMIC&quot;</span> : <span class="stringliteral">&quot;STATIC&quot;</span>) &lt;&lt; <span class="stringliteral">&quot;] [&quot;</span> &lt;&lt; s_d_value_set_idx &lt;&lt; <span class="stringliteral">&quot;] --\n&quot;</span>;</div>
<div class="line"><a id="l02696" name="l02696"></a><span class="lineno"> 2696</span>  opts-&gt;help_to_ostream(os);</div>
<div class="line"><a id="l02697" name="l02697"></a><span class="lineno"> 2697</span>} <span class="comment">// Config_manager::help_to_ostream_impl()</span></div>
<div class="line"><a id="l02698" name="l02698"></a><span class="lineno"> 2698</span> </div>
<div class="line"><a id="l02699" name="l02699"></a><span class="lineno"> 2699</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02700" name="l02700"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a0192ddc2cc7302bdc8720ee56a395c02"> 2700</a></span><span class="keywordtype">void</span> <a class="code hl_function" href="classflow_1_1cfg_1_1Config__manager.html#a0192ddc2cc7302bdc8720ee56a395c02">Config_manager&lt;S_d_value_set...&gt;::log_help</a>(<a class="code hl_enumeration" href="namespaceflow_1_1log.html#a5c602384e6fe9d7642740ac2fae4ad04">log::Sev</a> sev)<span class="keyword"> const</span></div>
<div class="line"><a id="l02701" name="l02701"></a><span class="lineno"> 2701</span><span class="keyword"></span>{</div>
<div class="line"><a id="l02702" name="l02702"></a><span class="lineno"> 2702</span>  <span class="keyword">using </span><a class="code hl_class" href="classflow_1_1util_1_1String__ostream.html">util::String_ostream</a>;</div>
<div class="line"><a id="l02703" name="l02703"></a><span class="lineno"> 2703</span>  <span class="keyword">using </span>std::flush;</div>
<div class="line"><a id="l02704" name="l02704"></a><span class="lineno"> 2704</span> </div>
<div class="line"><a id="l02705" name="l02705"></a><span class="lineno"> 2705</span>  String_ostream os;</div>
<div class="line"><a id="l02706" name="l02706"></a><span class="lineno"> 2706</span>  help_to_ostream(os.os());</div>
<div class="line"><a id="l02707" name="l02707"></a><span class="lineno"> 2707</span>  os.os() &lt;&lt; flush;</div>
<div class="line"><a id="l02708" name="l02708"></a><span class="lineno"> 2708</span>  <a class="code hl_define" href="log_8hpp.html#a692bbadd8b5c3e9cef7a0bbea1915e66">FLOW_LOG_WITH_CHECKING</a>(sev, os.str());</div>
<div class="line"><a id="l02709" name="l02709"></a><span class="lineno"> 2709</span>} <span class="comment">// Config_manager::log_help()</span></div>
<div class="line"><a id="l02710" name="l02710"></a><span class="lineno"> 2710</span> </div>
<div class="line"><a id="l02711" name="l02711"></a><span class="lineno"> 2711</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Value_set&gt;</div>
<div class="line"><a id="l02712" name="l02712"></a><span class="lineno"><a class="line" href="structflow_1_1cfg_1_1Final__validator__func.html#aa930ac2fbe3ad6abc07994984f875c81"> 2712</a></span><span class="keyword">typename</span> <a class="code hl_class" href="classflow_1_1Function.html">Final_validator_func&lt;Value_set&gt;::Type</a> <a class="code hl_function" href="structflow_1_1cfg_1_1Final__validator__func.html#aa930ac2fbe3ad6abc07994984f875c81">Final_validator_func&lt;Value_set&gt;::null</a>() <span class="comment">// Static.</span></div>
<div class="line"><a id="l02713" name="l02713"></a><span class="lineno"> 2713</span>{</div>
<div class="line"><a id="l02714" name="l02714"></a><span class="lineno"> 2714</span>  <span class="keywordflow">return</span> [](<span class="keyword">const</span> Value_set&amp;) -&gt; <a class="code hl_enumeration" href="namespaceflow_1_1cfg.html#a80b3319f3d3a657837d0d8b28d22ccc3">Final_validator_outcome</a> { <span class="keywordflow">return</span> <a class="code hl_enumvalue" href="namespaceflow_1_1cfg.html#a80b3319f3d3a657837d0d8b28d22ccc3a655ec6aa779cb1c799c9ba80f24e9567">Final_validator_outcome::S_ACCEPT</a>; };</div>
<div class="line"><a id="l02715" name="l02715"></a><span class="lineno"> 2715</span>}</div>
<div class="line"><a id="l02716" name="l02716"></a><span class="lineno"> 2716</span> </div>
<div class="line"><a id="l02717" name="l02717"></a><span class="lineno"> 2717</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span>... S_d_value_set&gt;</div>
<div class="line"><a id="l02718" name="l02718"></a><span class="lineno"><a class="line" href="classflow_1_1cfg_1_1Config__manager.html#a453d83bf1e8b57b1aaff511fbe913ecc"> 2718</a></span>std::ostream&amp; <a class="code hl_function" href="namespaceflow_1_1cfg.html#af310e567f2763a9736eda686030e6311">operator&lt;&lt;</a>(std::ostream&amp; os, <span class="keyword">const</span> <a class="code hl_class" href="classflow_1_1cfg_1_1Config__manager.html">Config_manager&lt;S_d_value_set...&gt;</a>&amp; val)</div>
<div class="line"><a id="l02719" name="l02719"></a><span class="lineno"> 2719</span>{</div>
<div class="line"><a id="l02720" name="l02720"></a><span class="lineno"> 2720</span>  <span class="keywordflow">return</span> os &lt;&lt; <span class="charliteral">&#39;[&#39;</span> &lt;&lt; val.<a class="code hl_variable" href="classflow_1_1cfg_1_1Config__manager.html#a68da387dad566805b969aded698661cb">m_nickname</a> &lt;&lt; <span class="stringliteral">&quot;]@&quot;</span> &lt;&lt; &amp;val;</div>
<div class="line"><a id="l02721" name="l02721"></a><span class="lineno"> 2721</span>}</div>
<div class="line"><a id="l02722" name="l02722"></a><span class="lineno"> 2722</span> </div>
<div class="line"><a id="l02723" name="l02723"></a><span class="lineno"> 2723</span>} <span class="comment">// namespace flow::cfg</span></div>
<div class="ttc" id="acfg__fwd_8hpp_html"><div class="ttname"><a href="cfg__fwd_8hpp.html">cfg_fwd.hpp</a></div></div>
<div class="ttc" id="acfg__manager__fwd_8hpp_html"><div class="ttname"><a href="cfg__manager__fwd_8hpp.html">cfg_manager_fwd.hpp</a></div></div>
<div class="ttc" id="aclassflow_1_1Function_html"><div class="ttname"><a href="classflow_1_1Function.html">flow::Function</a></div><div class="ttdef"><b>Definition:</b> <a href="common_8hpp_source.html#l00512">common.hpp:512</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html">flow::cfg::Config_manager</a></div><div class="ttdoc">Manages a config setup, intended for a single daemon process, by maintaining 1 or more set(s) of stat...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l00383">cfg_manager.hpp:385</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a0192ddc2cc7302bdc8720ee56a395c02"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a0192ddc2cc7302bdc8720ee56a395c02">flow::cfg::Config_manager::log_help</a></div><div class="ttdeci">void log_help(log::Sev sev=log::Sev::S_INFO) const</div><div class="ttdoc">Logs what help_to_ostream() would print.</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02700">cfg_manager.hpp:2700</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a08ba012812d46fcc6588d4bb8c4d04c9"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a08ba012812d46fcc6588d4bb8c4d04c9">flow::cfg::Config_manager::m_on_dynamic_change_funcs</a></div><div class="ttdeci">boost::array&lt; std::list&lt; On_dynamic_change_func &gt;, S_N_D_VALUE_SETS &gt; m_on_dynamic_change_funcs</div><div class="ttdoc">List of callbacks to execute after m_d_value_sets members (the pointers) are next assigned: one per e...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01393">cfg_manager.hpp:1393</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a19ae9775f51953805ea08086c276a78d"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a19ae9775f51953805ea08086c276a78d">flow::cfg::Config_manager::state_to_ostream</a></div><div class="ttdeci">void state_to_ostream(std::ostream &amp;os) const</div><div class="ttdoc">Prints a human-targeted long-form summary of our contents, doubling as a usage message and a dump of ...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02585">cfg_manager.hpp:2585</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a220535219634c62ed2a580934c76c481"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a220535219634c62ed2a580934c76c481">flow::cfg::Config_manager::log_state</a></div><div class="ttdeci">void log_state(log::Sev sev=log::Sev::S_INFO) const</div><div class="ttdoc">Logs what state_to_ostream() would print.</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02658">cfg_manager.hpp:2658</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a22bfec8082d0c7b5dff9ee7e98865707"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a22bfec8082d0c7b5dff9ee7e98865707">flow::cfg::Config_manager::apply_static</a></div><div class="ttdeci">bool apply_static(const fs::path &amp;static_cfg_path, const typename Final_validator_func&lt; Value_set &gt;::Type &amp;... final_validator_func, bool commit=true)</div><div class="ttdoc">Invoke this after construction to load the permanent set of static config from config sources includi...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01622">cfg_manager.hpp:1623</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a2503b020137aca00a8ee4b81fc921750"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a2503b020137aca00a8ee4b81fc921750">flow::cfg::Config_manager::apply_dynamic</a></div><div class="ttdeci">bool apply_dynamic(allow_invalid_defaults_tag_t, const fs::path &amp;dynamic_cfg_path, const typename Final_validator_func&lt; Value_set &gt;::Type &amp;... final_validator_func, bool commit=true)</div><div class="ttdoc">Identical to apply_dynamic() overload without allow_invalid_defaults_tag_t tag; except that – applica...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02165">cfg_manager.hpp:2166</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a26712af2d38d3afbeb52d21b7012a03c"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a26712af2d38d3afbeb52d21b7012a03c">flow::cfg::Config_manager::apply_dynamic</a></div><div class="ttdeci">bool apply_dynamic(const fs::path &amp;dynamic_cfg_path, const typename Final_validator_func&lt; Value_set &gt;::Type &amp;... final_validator_func, bool commit=true)</div><div class="ttdoc">Load the first or subsequent set of dynamic config from config source including a dynamic config file...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02155">cfg_manager.hpp:2156</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a2c9f7e2dd8973d5ff191eee1c2394cae"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a2c9f7e2dd8973d5ff191eee1c2394cae">flow::cfg::Config_manager::option_set_canonicalize_or_reject</a></div><div class="ttdeci">void option_set_canonicalize_or_reject(Option_set&lt; Value_set &gt; *opt_set, bool canonicalize_else_reject, bool *changed_or_null)</div><div class="ttdoc">Helper that executes opt_set-&gt;canonicalize_candidate() or opt_set-&gt;reject_candidate().</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01569">cfg_manager.hpp:1570</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a318e125f78cb7e471cae35e2651ab01f"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a318e125f78cb7e471cae35e2651ab01f">flow::cfg::Config_manager::opt_set</a></div><div class="ttdeci">Option_set&lt; Value_set &gt; * opt_set(size_t value_set_idx)</div><div class="ttdoc">Helper that obtains the Option_set in the slot m_s_d_opt_sets[value_set_idx], which stores an Option_...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01538">cfg_manager.hpp:1538</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a447aa1d42bc9f40af92ce5968c0edc82"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a447aa1d42bc9f40af92ce5968c0edc82">flow::cfg::Config_manager::m_d_value_sets</a></div><div class="ttdeci">boost::array&lt; Void_ptr, S_N_D_VALUE_SETS &gt; m_d_value_sets</div><div class="ttdoc">The dynamic config ref-counted handles returned by all_dynamic_values().</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01377">cfg_manager.hpp:1377</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a46a8745fe3fe54ede7f664b0a4cd8357"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a46a8745fe3fe54ede7f664b0a4cd8357">flow::cfg::Config_manager::m_d_baseline_value_sets</a></div><div class="ttdeci">boost::array&lt; Void_ptr, S_N_D_VALUE_SETS &gt; m_d_baseline_value_sets</div><div class="ttdoc">The baseline dynamic value sets, in the same order as S_N_D_VALUE_SETS dynamic S_d_value_set template...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01346">cfg_manager.hpp:1346</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a4e0dfe1e8f57d974a775f1320bd9856d"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a4e0dfe1e8f57d974a775f1320bd9856d">flow::cfg::Config_manager::unregister_dynamic_change_listener</a></div><div class="ttdeci">void unregister_dynamic_change_listener(const On_dynamic_change_func_handle &amp;handle)</div><div class="ttdoc">Remove a previously registered dynamic change callback.</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01609">cfg_manager.hpp:1609</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a4e724d9d455ea31439c6832d0bc645bd"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a4e724d9d455ea31439c6832d0bc645bd">flow::cfg::Config_manager::m_s_d_opt_sets</a></div><div class="ttdeci">boost::array&lt; Void_ptr, S_N_VALUE_SETS &gt; m_s_d_opt_sets</div><div class="ttdoc">The static and dynamic value sets, in the same order as the S_N_VALUE_SETS S_d_value_set template arg...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01316">cfg_manager.hpp:1316</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a57140907e43a66705625d391e85e3c52"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a57140907e43a66705625d391e85e3c52">flow::cfg::Config_manager::invoke_dynamic_change_listeners</a></div><div class="ttdeci">void invoke_dynamic_change_listeners(size_t d_value_set_idx, bool init) const</div><div class="ttdoc">Invokes the registered listeners for the given dynamic config slot (synchronously).</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02433">cfg_manager.hpp:2433</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a5d85fa5a1ed933c9b85444ddb9a416b1"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a5d85fa5a1ed933c9b85444ddb9a416b1">flow::cfg::Config_manager::apply_static_and_dynamic</a></div><div class="ttdeci">bool apply_static_and_dynamic(allow_invalid_defaults_tag_t, const fs::path &amp;cfg_path, const typename Final_validator_func&lt; S_d_value_set &gt;::Type &amp;... final_validator_func, bool commit=true)</div><div class="ttdoc">Identical to apply_static_and_dynamic() overload without allow_invalid_defaults_tag_t tag; but skips ...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01950">cfg_manager.hpp:1951</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a616c39cdf1c6f7f4d2af3a3055edf486"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a616c39cdf1c6f7f4d2af3a3055edf486">flow::cfg::Config_manager::all_static_values_candidates</a></div><div class="ttdeci">void all_static_values_candidates(const Value_set **... value_set_or_null) const</div><div class="ttdoc">Similar to all_static_values(), but if called from within a validator function passed to apply_static...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02479">cfg_manager.hpp:2479</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a62619206c49b1b39c887162d8b6a2305"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a62619206c49b1b39c887162d8b6a2305">flow::cfg::Config_manager::apply_static_and_dynamic_impl</a></div><div class="ttdeci">bool apply_static_and_dynamic_impl(bool allow_invalid_defaults, const fs::path &amp;cfg_path, const typename Final_validator_func&lt; S_d_value_set &gt;::Type &amp;... final_validator_func, bool commit)</div><div class="ttdoc">Implements all apply_static_and_dynamic() overloads.</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01960">cfg_manager.hpp:1961</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a6768eb0c92bd11fd84986058903b10d4"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a6768eb0c92bd11fd84986058903b10d4">flow::cfg::Config_manager::allow_invalid_defaults_tag_t</a></div><div class="ttdeci">allow_invalid_defaults_tag_t</div><div class="ttdoc">Tag type: indicates an apply_*() method must allow invalid defaults and only complain if the config s...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l00395">cfg_manager.hpp:396</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a6768eb0c92bd11fd84986058903b10d4a7ea4d19303bcf5de0947176d9637a9ed"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a6768eb0c92bd11fd84986058903b10d4a7ea4d19303bcf5de0947176d9637a9ed">flow::cfg::Config_manager::S_ALLOW_INVALID_DEFAULTS</a></div><div class="ttdeci">@ S_ALLOW_INVALID_DEFAULTS</div><div class="ttdoc">Sole value for tag type allow_invalid_defaults_tag_t.</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l00398">cfg_manager.hpp:397</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a68da387dad566805b969aded698661cb"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a68da387dad566805b969aded698661cb">flow::cfg::Config_manager::m_nickname</a></div><div class="ttdeci">const std::string m_nickname</div><div class="ttdoc">See nickname ctor arg.</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l00988">cfg_manager.hpp:988</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a6afb8620600dcb54d41211ef68859f93"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a6afb8620600dcb54d41211ef68859f93">flow::cfg::Config_manager::all_dynamic_values</a></div><div class="ttdeci">void all_dynamic_values(typename Value_set::Const_ptr *... value_set_or_null) const</div><div class="ttdoc">Obtain ref-counted pointers to each currently-canonical set of dynamic config; each pointed-at struct...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02539">cfg_manager.hpp:2540</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a6f366f4070a90740e27d73029852e55f"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a6f366f4070a90740e27d73029852e55f">flow::cfg::Config_manager::Void_ptr</a></div><div class="ttdeci">boost::shared_ptr&lt; void &gt; Void_ptr</div><div class="ttdoc">Short-hand for shared_ptr-to-void type used to store variable-type values in internal containers.</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l00994">cfg_manager.hpp:994</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a76c7224711ef8a51c7005629e4eae6e7"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a76c7224711ef8a51c7005629e4eae6e7">flow::cfg::Config_manager::all_static_values</a></div><div class="ttdeci">void all_static_values(const Value_set **... value_set_or_null) const</div><div class="ttdoc">Emit a pointer to each permanently set static config value set; the same pointers are emitted through...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02455">cfg_manager.hpp:2455</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a8431806f82bed676f5fedb3b64f67245"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a8431806f82bed676f5fedb3b64f67245">flow::cfg::Config_manager::static_values</a></div><div class="ttdeci">const Value_set &amp; static_values(size_t s_value_set_idx) const</div><div class="ttdoc">Similar to all_static_values(), but obtains the static config in one specified slot as opposed to all...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02509">cfg_manager.hpp:2509</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a859a36cccd8196d9648f67de8656360a"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a859a36cccd8196d9648f67de8656360a">flow::cfg::Config_manager::save_dynamic_value_set_locked</a></div><div class="ttdeci">void save_dynamic_value_set_locked(Option_set&lt; Value_set &gt; *opt_set, size_t d_value_set_idx)</div><div class="ttdoc">Little helper that, having assumed m_d_value_sets_mutex is locked, makes a newly allocated copy of th...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02418">cfg_manager.hpp:2419</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a8864e575c78251d3b8e109f86f29b703"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a8864e575c78251d3b8e109f86f29b703">flow::cfg::Config_manager::apply_dynamic_impl</a></div><div class="ttdeci">bool apply_dynamic_impl(bool allow_invalid_defaults, const fs::path &amp;dynamic_cfg_path, const typename Final_validator_func&lt; Value_set &gt;::Type &amp;... final_validator_func, bool commit)</div><div class="ttdoc">Implements all apply_dynamic() overloads.</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02176">cfg_manager.hpp:2177</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a8be0e0697c1b106c7170795ee4a225e8"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a8be0e0697c1b106c7170795ee4a225e8">flow::cfg::Config_manager::help_to_ostream_impl</a></div><div class="ttdeci">void help_to_ostream_impl(size_t value_set_idx, std::ostream &amp;os) const</div><div class="ttdoc">Helper of help_to_ostream() for m_s_d_opt_sets slot value_set_idx.</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02683">cfg_manager.hpp:2683</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a978295c03998af212b464061d780520b"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a978295c03998af212b464061d780520b">flow::cfg::Config_manager::register_dynamic_change_listener</a></div><div class="ttdeci">On_dynamic_change_func_handle register_dynamic_change_listener(size_t d_value_set_idx, On_dynamic_change_func &amp;&amp;on_dynamic_change_func_moved)</div><div class="ttdoc">Saves the given callback; next time apply_dynamic(commit = true) or apply_static_and_dynamic(commit =...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01588">cfg_manager.hpp:1589</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a9c07f711e98435d00420277f1c20be75"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a9c07f711e98435d00420277f1c20be75">flow::cfg::Config_manager::S_N_S_VALUE_SETS</a></div><div class="ttdeci">static constexpr size_t S_N_S_VALUE_SETS</div><div class="ttdoc">The number of static value sets (including any Null_value_sets).</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l00413">cfg_manager.hpp:413</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_a9d9811d1b4aab2c4ea3e6813d4161304"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#a9d9811d1b4aab2c4ea3e6813d4161304">flow::cfg::Config_manager::apply_static_and_dynamic</a></div><div class="ttdeci">bool apply_static_and_dynamic(const fs::path &amp;cfg_path, const typename Final_validator_func&lt; S_d_value_set &gt;::Type &amp;... final_validator_func, bool commit=true)</div><div class="ttdoc">If you use dynamic config, and you allow for initial values for dynamic options to be read from the s...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01941">cfg_manager.hpp:1942</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_aa0d03f4dcf7be2c21023c4073ac68b85"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#aa0d03f4dcf7be2c21023c4073ac68b85">flow::cfg::Config_manager::Update_type</a></div><div class="ttdeci">Update_type</div><div class="ttdoc">Useful at least in the context of multi-source (commit == false) apply_*() methods,...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01000">cfg_manager.hpp:1001</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_aa0e43bae09415b5a12a6b9e9f3e01756"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#aa0e43bae09415b5a12a6b9e9f3e01756">flow::cfg::Config_manager::m_dynamic_values_set</a></div><div class="ttdeci">bool m_dynamic_values_set</div><div class="ttdoc">Starts false; set to true permanently on successful apply_static_and_dynamic() or apply_dynamic().</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01396">cfg_manager.hpp:1396</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_aa7785bcdb7fae9ae7ef6f1919b1f8045"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#aa7785bcdb7fae9ae7ef6f1919b1f8045">flow::cfg::Config_manager::apply_static_or_dynamic_impl</a></div><div class="ttdeci">bool apply_static_or_dynamic_impl(bool dyn_else_st, const fs::path &amp;cfg_path, const boost::unordered_set&lt; std::string &gt; &amp;all_opt_names_or_empty, const typename Final_validator_func&lt; Value_set &gt;::Type &amp;... final_validator_func)</div><div class="ttdoc">Work-horse helper that parses either all static value sets or all dynamic value sets from the specifi...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01771">cfg_manager.hpp:1772</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_ab8463fe083d97fd4d4b49f7265726d2c"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#ab8463fe083d97fd4d4b49f7265726d2c">flow::cfg::Config_manager::m_d_value_sets_mutex</a></div><div class="ttdeci">util::Mutex_non_recursive m_d_value_sets_mutex</div><div class="ttdoc">Mutex protecting m_d_value_sets.</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01380">cfg_manager.hpp:1380</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_abe40d6451276e0d4c7c0867669791f9c"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#abe40d6451276e0d4c7c0867669791f9c">flow::cfg::Config_manager::d_baseline_value_set</a></div><div class="ttdeci">Value_set * d_baseline_value_set(size_t d_value_set_idx)</div><div class="ttdoc">Helper that obtains the baseline dynamic Value_set in the slot m_d_baseline_value_sets[value_set_idx]...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01550">cfg_manager.hpp:1550</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_abe9d2c5d3a9747a26a4e6233a0f1feed"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#abe9d2c5d3a9747a26a4e6233a0f1feed">flow::cfg::Config_manager::reject_candidates_if_update_type_changed</a></div><div class="ttdeci">void reject_candidates_if_update_type_changed(Update_type this_update_type)</div><div class="ttdoc">Helper for the top of apply_*() that guards against a call to apply_Y() following apply_X(commit == f...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02396">cfg_manager.hpp:2396</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_ac1ab5cefe86e6aaa0518d675f309907e"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#ac1ab5cefe86e6aaa0518d675f309907e">flow::cfg::Config_manager::reject_candidates</a></div><div class="ttdeci">void reject_candidates()</div><div class="ttdoc">Cancel a not-yet-canonicalized (incomplete) multi-source update, if one is in progress.</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02366">cfg_manager.hpp:2366</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_ac2239443cf48bfdaa78c95af935e1d0f"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#ac2239443cf48bfdaa78c95af935e1d0f">flow::cfg::Config_manager::dynamic_values</a></div><div class="ttdeci">Value_set::Const_ptr dynamic_values(size_t d_value_set_idx) const</div><div class="ttdoc">Similar to all_dynamic_values() but obtains the dynamic config in one specified slot as opposed to al...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02572">cfg_manager.hpp:2572</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_ac26c2d6efe1670e940badccb3fdea609"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#ac26c2d6efe1670e940badccb3fdea609">flow::cfg::Config_manager::S_N_D_VALUE_SETS</a></div><div class="ttdeci">static constexpr size_t S_N_D_VALUE_SETS</div><div class="ttdoc">The number of dynamic value sets (including any Null_value_sets).</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l00415">cfg_manager.hpp:415</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_ac416a9ecc83d4209b5b9767d01984aa3"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#ac416a9ecc83d4209b5b9767d01984aa3">flow::cfg::Config_manager::apply_impl</a></div><div class="ttdeci">bool apply_impl(Option_set&lt; Value_set &gt; *opt_set, const Value_set *baseline_value_set_or_null, const fs::path &amp;cfg_path, const boost::unordered_set&lt; std::string &gt; &amp;all_opt_names_or_empty, const typename Final_validator_func&lt; Value_set &gt;::Type &amp;final_validator_func, bool *skip_parsing)</div><div class="ttdoc">Work-horse helper that parses into one given Option_set in m_s_d_opt_sets (from opt_set()) from the s...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01821">cfg_manager.hpp:1822</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_ac74b46ed066f012a633ca16c400441ac"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#ac74b46ed066f012a633ca16c400441ac">flow::cfg::Config_manager::m_multi_src_update_in_progress</a></div><div class="ttdeci">Update_type m_multi_src_update_in_progress</div><div class="ttdoc">In short, truthy if and only if a commit == false update is currently in progress,...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01424">cfg_manager.hpp:1424</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_ad320a74f83474c93cce385b0b9da887e"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#ad320a74f83474c93cce385b0b9da887e">flow::cfg::Config_manager::apply_static_impl</a></div><div class="ttdeci">bool apply_static_impl(bool allow_invalid_defaults, const fs::path &amp;static_cfg_path, const typename Final_validator_func&lt; Value_set &gt;::Type &amp;... final_validator_func, bool commit)</div><div class="ttdoc">Implements all apply_static() overloads.</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01643">cfg_manager.hpp:1644</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_ad49d54a2ae34b14c276cf3de05c3c4f8"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#ad49d54a2ae34b14c276cf3de05c3c4f8">flow::cfg::Config_manager::S_N_VALUE_SETS</a></div><div class="ttdeci">static constexpr size_t S_N_VALUE_SETS</div><div class="ttdoc">The number of template params in this Config_manager instantiation. It must be even and positive.</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l00408">cfg_manager.hpp:408</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_ad59bfabf66e01922542629bae77508ad"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#ad59bfabf66e01922542629bae77508ad">flow::cfg::Config_manager::Config_manager</a></div><div class="ttdeci">Config_manager(log::Logger *logger_ptr, util::String_view nickname, typename Option_set&lt; S_d_value_set &gt;::Declare_options_func &amp;&amp;... declare_opts_func_moved)</div><div class="ttdoc">Constructs a Config_manager ready to read initial config via apply_*() and other setup methods; and f...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01470">cfg_manager.hpp:1471</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_ad5cda6ace05e8bbe52a5129ed1c0720c"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#ad5cda6ace05e8bbe52a5129ed1c0720c">flow::cfg::Config_manager::help_to_ostream</a></div><div class="ttdeci">void help_to_ostream(std::ostream &amp;os) const</div><div class="ttdoc">Prints a human-targeted long-form usage message that includes all options with their descriptions and...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02670">cfg_manager.hpp:2670</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_ae034a71792f952256c18e385475627d1"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#ae034a71792f952256c18e385475627d1">flow::cfg::Config_manager::static_values_candidate</a></div><div class="ttdeci">const Value_set &amp; static_values_candidate(size_t s_value_set_idx) const</div><div class="ttdoc">Similar to static_values(), but if called from within a validator function passed to apply_static() o...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02518">cfg_manager.hpp:2518</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_af027c6f4b595f1f8ebbd6d41ad705f5e"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#af027c6f4b595f1f8ebbd6d41ad705f5e">flow::cfg::Config_manager::apply_static</a></div><div class="ttdeci">bool apply_static(allow_invalid_defaults_tag_t, const fs::path &amp;static_cfg_path, const typename Final_validator_func&lt; Value_set &gt;::Type &amp;... final_validator_func, bool commit=true)</div><div class="ttdoc">Identical to apply_static() overload without allow_invalid_defaults_tag_t tag; but skips the stringen...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01632">cfg_manager.hpp:1633</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_af54e2f1360834ece6fd06d34b387978c"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#af54e2f1360834ece6fd06d34b387978c">flow::cfg::Config_manager::opt_set</a></div><div class="ttdeci">const Option_set&lt; Value_set &gt; * opt_set(size_t value_set_idx) const</div><div class="ttdoc">const overload of the other opt_set() helper.</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01562">cfg_manager.hpp:1562</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Config__manager_html_afbf1eca924be81654eaa4140814a816f"><div class="ttname"><a href="classflow_1_1cfg_1_1Config__manager.html#afbf1eca924be81654eaa4140814a816f">flow::cfg::Config_manager::state_to_ostream_impl</a></div><div class="ttdeci">void state_to_ostream_impl(size_t value_set_idx, std::ostream &amp;os) const</div><div class="ttdoc">Helper of state_to_ostream() for m_s_d_opt_sets slot value_set_idx.</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02598">cfg_manager.hpp:2598</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Option__set_html"><div class="ttname"><a href="classflow_1_1cfg_1_1Option__set.html">flow::cfg::Option_set</a></div><div class="ttdoc">The core config-parsing facility, which builds parsing/comparison/output capabilities on top of a giv...</div><div class="ttdef"><b>Definition:</b> <a href="option__set_8hpp_source.html#l00418">option_set.hpp:422</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Option__set_html_a93ab889bf230d21961c22bd4bf21e06a"><div class="ttname"><a href="classflow_1_1cfg_1_1Option__set.html#a93ab889bf230d21961c22bd4bf21e06a">flow::cfg::Option_set::values</a></div><div class="ttdeci">const Values &amp; values() const</div><div class="ttdoc">Externally immutable internally stored canonical (current) config values as last constructed or parse...</div><div class="ttdef"><b>Definition:</b> <a href="option__set_8hpp_source.html#l01490">option_set.hpp:1490</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Option__set_html_aa1f780bfd3a5ff07ade1e36785e28f49"><div class="ttname"><a href="classflow_1_1cfg_1_1Option__set.html#aa1f780bfd3a5ff07ade1e36785e28f49">flow::cfg::Option_set::canonicalize_candidate</a></div><div class="ttdeci">void canonicalize_candidate(bool *change_detected=0)</div><div class="ttdoc">In PARSING state enters CANONICAL state, finalizing values() from values_candidate().</div><div class="ttdef"><b>Definition:</b> <a href="option__set_8hpp_source.html#l02042">option_set.hpp:2042</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Option__set_html_ac5452a6e866c911df46d948f02b6a587"><div class="ttname"><a href="classflow_1_1cfg_1_1Option__set.html#ac5452a6e866c911df46d948f02b6a587">flow::cfg::Option_set::reject_candidate</a></div><div class="ttdeci">void reject_candidate()</div><div class="ttdoc">In PARSING state, returns to CANONICAL state, as if no parse attempts have occurred.</div><div class="ttdef"><b>Definition:</b> <a href="option__set_8hpp_source.html#l02075">option_set.hpp:2075</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Option__set_html_accd086867406387070ac766b03e7998c"><div class="ttname"><a href="classflow_1_1cfg_1_1Option__set.html#accd086867406387070ac766b03e7998c">flow::cfg::Option_set::null</a></div><div class="ttdeci">bool null() const</div><div class="ttdoc">Return true if and only if the option-declaring function passed to the constructor declared no option...</div><div class="ttdef"><b>Definition:</b> <a href="option__set_8hpp_source.html#l01484">option_set.hpp:1484</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Option__set_html_adce212853383183bd1b60505157f7215"><div class="ttname"><a href="classflow_1_1cfg_1_1Option__set.html#adce212853383183bd1b60505157f7215">flow::cfg::Option_set::values_candidate</a></div><div class="ttdeci">const Values * values_candidate() const</div><div class="ttdoc">Returns null in CANONICAL state; or in PARSING state a pointer to the not-yet-canonical values after ...</div><div class="ttdef"><b>Definition:</b> <a href="option__set_8hpp_source.html#l01502">option_set.hpp:1502</a></div></div>
<div class="ttc" id="aclassflow_1_1cfg_1_1Option__set_html_afcd900a94beabe8e9964efc3bc1b91bc"><div class="ttname"><a href="classflow_1_1cfg_1_1Option__set.html#afcd900a94beabe8e9964efc3bc1b91bc">flow::cfg::Option_set::parse_direct_values</a></div><div class="ttdeci">void parse_direct_values(const Values &amp;src_values)</div><div class="ttdoc">Enters into (from CANONICAL state) or continues in PARSING state by simply setting *values_candidate(...</div><div class="ttdef"><b>Definition:</b> <a href="option__set_8hpp_source.html#l01993">option_set.hpp:1993</a></div></div>
<div class="ttc" id="aclassflow_1_1log_1_1Log__context_html"><div class="ttname"><a href="classflow_1_1log_1_1Log__context.html">flow::log::Log_context</a></div><div class="ttdoc">Convenience class that simply stores a Logger and/or Component passed into a constructor; and returns...</div><div class="ttdef"><b>Definition:</b> <a href="log_8hpp_source.html#l01609">log.hpp:1610</a></div></div>
<div class="ttc" id="aclassflow_1_1log_1_1Log__context_html_af4db395042b065b00398cd59845dcb4d"><div class="ttname"><a href="classflow_1_1log_1_1Log__context.html#af4db395042b065b00398cd59845dcb4d">flow::log::Log_context::get_logger</a></div><div class="ttdeci">Logger * get_logger() const</div><div class="ttdoc">Returns the stored Logger pointer, particularly as many FLOW_LOG_*() macros expect.</div><div class="ttdef"><b>Definition:</b> <a href="log_8cpp_source.html#l00217">log.cpp:217</a></div></div>
<div class="ttc" id="aclassflow_1_1log_1_1Logger_html"><div class="ttname"><a href="classflow_1_1log_1_1Logger.html">flow::log::Logger</a></div><div class="ttdoc">Interface that the user should implement, passing the implementing Logger into logging classes (Flow'...</div><div class="ttdef"><b>Definition:</b> <a href="log_8hpp_source.html#l01280">log.hpp:1284</a></div></div>
<div class="ttc" id="aclassflow_1_1util_1_1Shared__ptr__alias__holder_html"><div class="ttname"><a href="classflow_1_1util_1_1Shared__ptr__alias__holder.html">flow::util::Shared_ptr_alias_holder</a></div><div class="ttdoc">Convenience class template that endows the given subclass T with nested aliases Ptr and Const_ptr ali...</div><div class="ttdef"><b>Definition:</b> <a href="shared__ptr__alias__holder_8hpp_source.html#l00119">shared_ptr_alias_holder.hpp:120</a></div></div>
<div class="ttc" id="aclassflow_1_1util_1_1String__ostream_html"><div class="ttname"><a href="classflow_1_1util_1_1String__ostream.html">flow::util::String_ostream</a></div><div class="ttdoc">Similar to ostringstream but allows fast read-only access directly into the std::string being written...</div><div class="ttdef"><b>Definition:</b> <a href="string__ostream_8hpp_source.html#l00045">string_ostream.hpp:47</a></div></div>
<div class="ttc" id="alog_8hpp_html_a325fdd4b5cf0be49b37d3b7b7c29070d"><div class="ttname"><a href="log_8hpp.html#a325fdd4b5cf0be49b37d3b7b7c29070d">FLOW_LOG_INFO</a></div><div class="ttdeci">#define FLOW_LOG_INFO(ARG_stream_fragment)</div><div class="ttdoc">Logs an INFO message into flow::log::Logger *get_logger() with flow::log::Component get_log_component...</div><div class="ttdef"><b>Definition:</b> <a href="log_8hpp_source.html#l00197">log.hpp:197</a></div></div>
<div class="ttc" id="alog_8hpp_html_a626c7dc4d3b4dc0b32a8aac8624d66bc"><div class="ttname"><a href="log_8hpp.html#a626c7dc4d3b4dc0b32a8aac8624d66bc">FLOW_LOG_WARNING</a></div><div class="ttdeci">#define FLOW_LOG_WARNING(ARG_stream_fragment)</div><div class="ttdoc">Logs a WARNING message into flow::log::Logger *get_logger() with flow::log::Component get_log_compone...</div><div class="ttdef"><b>Definition:</b> <a href="log_8hpp_source.html#l00152">log.hpp:152</a></div></div>
<div class="ttc" id="alog_8hpp_html_a692bbadd8b5c3e9cef7a0bbea1915e66"><div class="ttname"><a href="log_8hpp.html#a692bbadd8b5c3e9cef7a0bbea1915e66">FLOW_LOG_WITH_CHECKING</a></div><div class="ttdeci">#define FLOW_LOG_WITH_CHECKING(ARG_sev, ARG_stream_fragment)</div><div class="ttdoc">Logs a message of the specified severity into flow::log::Logger *get_logger() with flow::log::Compone...</div><div class="ttdef"><b>Definition:</b> <a href="log_8hpp_source.html#l00489">log.hpp:489</a></div></div>
<div class="ttc" id="alog_8hpp_html_affcf2e4c496ce3f42adf981669c623b8"><div class="ttname"><a href="log_8hpp.html#affcf2e4c496ce3f42adf981669c623b8">FLOW_LOG_TRACE</a></div><div class="ttdeci">#define FLOW_LOG_TRACE(ARG_stream_fragment)</div><div class="ttdoc">Logs a TRACE message into flow::log::Logger *get_logger() with flow::log::Component get_log_component...</div><div class="ttdef"><b>Definition:</b> <a href="log_8hpp_source.html#l00227">log.hpp:227</a></div></div>
<div class="ttc" id="anamespaceflow_1_1cfg_html"><div class="ttname"><a href="namespaceflow_1_1cfg.html">flow::cfg</a></div><div class="ttdoc">Flow module that facilitates configuring modules, such as applications and APIs, via statically and/o...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__fwd_8hpp_source.html#l00111">cfg_fwd.hpp:112</a></div></div>
<div class="ttc" id="anamespaceflow_1_1cfg_html_a80b3319f3d3a657837d0d8b28d22ccc3"><div class="ttname"><a href="namespaceflow_1_1cfg.html#a80b3319f3d3a657837d0d8b28d22ccc3">flow::cfg::Final_validator_outcome</a></div><div class="ttdeci">Final_validator_outcome</div><div class="ttdoc">Result enumeration for a Final_validator_func::Type function which is used by a Config_manager user w...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager__fwd_8hpp_source.html#l00043">cfg_manager_fwd.hpp:44</a></div></div>
<div class="ttc" id="anamespaceflow_1_1cfg_html_a80b3319f3d3a657837d0d8b28d22ccc3a655ec6aa779cb1c799c9ba80f24e9567"><div class="ttname"><a href="namespaceflow_1_1cfg.html#a80b3319f3d3a657837d0d8b28d22ccc3a655ec6aa779cb1c799c9ba80f24e9567">flow::cfg::Final_validator_outcome::S_ACCEPT</a></div><div class="ttdeci">@ S_ACCEPT</div><div class="ttdoc">The holistically-checked cumulative Value_set has no problems and shall be accepted into the candidat...</div></div>
<div class="ttc" id="anamespaceflow_1_1cfg_html_a80b3319f3d3a657837d0d8b28d22ccc3ace64a8fc2c16fb21be22f603ef4d2eec"><div class="ttname"><a href="namespaceflow_1_1cfg.html#a80b3319f3d3a657837d0d8b28d22ccc3ace64a8fc2c16fb21be22f603ef4d2eec">flow::cfg::Final_validator_outcome::S_SKIP</a></div><div class="ttdeci">@ S_SKIP</div><div class="ttdoc">The holistically-checked cumulative Value_set has contents such that the validator function decided t...</div></div>
<div class="ttc" id="anamespaceflow_1_1cfg_html_a80b3319f3d3a657837d0d8b28d22ccc3aec1a4aed91659725c96b0b8378dba316"><div class="ttname"><a href="namespaceflow_1_1cfg.html#a80b3319f3d3a657837d0d8b28d22ccc3aec1a4aed91659725c96b0b8378dba316">flow::cfg::Final_validator_outcome::S_FAIL</a></div><div class="ttdeci">@ S_FAIL</div><div class="ttdoc">The holistically-checked cumulative Value_set has invalid contents; the candidate shall be rejected,...</div></div>
<div class="ttc" id="anamespaceflow_1_1cfg_html_adfe41c8484a878742976ddb84aa9e2d8"><div class="ttname"><a href="namespaceflow_1_1cfg.html#adfe41c8484a878742976ddb84aa9e2d8">flow::cfg::null_declare_opts_func</a></div><div class="ttdeci">Option_set&lt; Null_value_set &gt;::Declare_options_func null_declare_opts_func()</div><div class="ttdoc">Returns a value usable as declare_opts_func_moved Config_manager ctor arg for a Null_value_set value ...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8cpp_source.html#l00026">cfg_manager.cpp:26</a></div></div>
<div class="ttc" id="anamespaceflow_1_1cfg_html_af1a4e0a153ec8216ead76450e900e386"><div class="ttname"><a href="namespaceflow_1_1cfg.html#af1a4e0a153ec8216ead76450e900e386">flow::cfg::null_final_validator_func</a></div><div class="ttdeci">Final_validator_func&lt; Null_value_set &gt;::Type null_final_validator_func()</div><div class="ttdoc">Returns a value usable as final_validator_func arg to Config_manager::apply_static() and others – for...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8cpp_source.html#l00031">cfg_manager.cpp:31</a></div></div>
<div class="ttc" id="anamespaceflow_1_1cfg_html_af310e567f2763a9736eda686030e6311"><div class="ttname"><a href="namespaceflow_1_1cfg.html#af310e567f2763a9736eda686030e6311">flow::cfg::operator&lt;&lt;</a></div><div class="ttdeci">std::ostream &amp; operator&lt;&lt;(std::ostream &amp;os, const Option_set&lt; Value_set &gt; &amp;val)</div><div class="ttdoc">Serializes (briefly) an Option_set to a standard output stream.</div><div class="ttdef"><b>Definition:</b> <a href="option__set_8hpp_source.html#l02154">option_set.hpp:2154</a></div></div>
<div class="ttc" id="anamespaceflow_1_1log_html_a5c602384e6fe9d7642740ac2fae4ad04"><div class="ttname"><a href="namespaceflow_1_1log.html#a5c602384e6fe9d7642740ac2fae4ad04">flow::log::Sev</a></div><div class="ttdeci">Sev</div><div class="ttdoc">Enumeration containing one of several message severity levels, ordered from highest to lowest.</div><div class="ttdef"><b>Definition:</b> <a href="log__fwd_8hpp_source.html#l00223">log_fwd.hpp:224</a></div></div>
<div class="ttc" id="anamespaceflow_1_1log_html_a5c602384e6fe9d7642740ac2fae4ad04ac238793326fae17afcc849e96b96e8e7"><div class="ttname"><a href="namespaceflow_1_1log.html#a5c602384e6fe9d7642740ac2fae4ad04ac238793326fae17afcc849e96b96e8e7">flow::log::Sev::S_INFO</a></div><div class="ttdeci">@ S_INFO</div><div class="ttdoc">Message indicates a not-&quot;bad&quot; condition that is not frequent enough to be of severity Sev::S_TRACE.</div></div>
<div class="ttc" id="anamespaceflow_1_1util_html_a5d2247b715da63e4b960909561b90ae7"><div class="ttname"><a href="namespaceflow_1_1util.html#a5d2247b715da63e4b960909561b90ae7">flow::util::Lock_guard</a></div><div class="ttdeci">boost::unique_lock&lt; Mutex &gt; Lock_guard</div><div class="ttdoc">Short-hand for advanced-capability RAII lock guard for any mutex, ensuring exclusive ownership of tha...</div><div class="ttdef"><b>Definition:</b> <a href="util__fwd_8hpp_source.html#l00265">util_fwd.hpp:265</a></div></div>
<div class="ttc" id="anamespaceflow_1_1util_html_a685b86585da2fa5186f51854e7ae1561"><div class="ttname"><a href="namespaceflow_1_1util.html#a685b86585da2fa5186f51854e7ae1561">flow::util::ostream_op_string</a></div><div class="ttdeci">std::string ostream_op_string(T const &amp;... ostream_args)</div><div class="ttdoc">Equivalent to ostream_op_to_string() but returns a new string by value instead of writing to the call...</div><div class="ttdef"><b>Definition:</b> <a href="util_2util_8hpp_source.html#l00381">util.hpp:381</a></div></div>
<div class="ttc" id="anamespaceflow_1_1util_html_add6ade273326f27eaf9bfd170a909626"><div class="ttname"><a href="namespaceflow_1_1util.html#add6ade273326f27eaf9bfd170a909626">flow::util::Mutex_non_recursive</a></div><div class="ttdeci">boost::mutex Mutex_non_recursive</div><div class="ttdoc">Short-hand for non-reentrant, exclusive mutex. (&quot;Reentrant&quot; = one can lock an already-locked-in-that-...</div><div class="ttdef"><b>Definition:</b> <a href="util__fwd_8hpp_source.html#l00215">util_fwd.hpp:215</a></div></div>
<div class="ttc" id="anamespaceflow_1_1util_html_ae4dc52186797094b3040379ff19124c9"><div class="ttname"><a href="namespaceflow_1_1util.html#ae4dc52186797094b3040379ff19124c9">flow::util::String_view</a></div><div class="ttdeci">Basic_string_view&lt; char &gt; String_view</div><div class="ttdoc">Commonly used char-based Basic_string_view. See its doc header.</div><div class="ttdef"><b>Definition:</b> <a href="string__view_8hpp_source.html#l00191">string_view.hpp:191</a></div></div>
<div class="ttc" id="anamespaceflow_html_a3938730ab4b89daf13d027a5f620e7ce"><div class="ttname"><a href="namespaceflow.html#a3938730ab4b89daf13d027a5f620e7ce">flow::Flow_log_component</a></div><div class="ttdeci">Flow_log_component</div><div class="ttdoc">The flow::log::Component payload enumeration comprising various log components used by Flow's own int...</div><div class="ttdef"><b>Definition:</b> <a href="common_8hpp_source.html#l00637">common.hpp:638</a></div></div>
<div class="ttc" id="aoption__set_8hpp_html"><div class="ttname"><a href="option__set_8hpp.html">option_set.hpp</a></div></div>
<div class="ttc" id="ashared__ptr__alias__holder_8hpp_html"><div class="ttname"><a href="shared__ptr__alias__holder_8hpp.html">shared_ptr_alias_holder.hpp</a></div></div>
<div class="ttc" id="astructflow_1_1cfg_1_1Config__manager_1_1On__dynamic__change__func__handle_html"><div class="ttname"><a href="structflow_1_1cfg_1_1Config__manager_1_1On__dynamic__change__func__handle.html">flow::cfg::Config_manager::On_dynamic_change_func_handle</a></div><div class="ttdoc">Opaque handle for managing a dynamic config change callback.</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01429">cfg_manager.hpp:1430</a></div></div>
<div class="ttc" id="astructflow_1_1cfg_1_1Config__manager_1_1On__dynamic__change__func__handle_html_a555e60805c7ba2326892ef270171caa7"><div class="ttname"><a href="structflow_1_1cfg_1_1Config__manager_1_1On__dynamic__change__func__handle.html#a555e60805c7ba2326892ef270171caa7">flow::cfg::Config_manager::On_dynamic_change_func_handle::m_d_value_set_idx</a></div><div class="ttdeci">size_t m_d_value_set_idx</div><div class="ttdoc">Opaque handle detail.</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01437">cfg_manager.hpp:1437</a></div></div>
<div class="ttc" id="astructflow_1_1cfg_1_1Config__manager_1_1On__dynamic__change__func__handle_html_a6d4eafd7d31261d7bdc8eb88a558fb2f"><div class="ttname"><a href="structflow_1_1cfg_1_1Config__manager_1_1On__dynamic__change__func__handle.html#a6d4eafd7d31261d7bdc8eb88a558fb2f">flow::cfg::Config_manager::On_dynamic_change_func_handle::m_pos</a></div><div class="ttdeci">std::list&lt; On_dynamic_change_func &gt;::const_iterator m_pos</div><div class="ttdoc">Opaque handle detail.</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l01444">cfg_manager.hpp:1444</a></div></div>
<div class="ttc" id="astructflow_1_1cfg_1_1Final__validator__func_html"><div class="ttname"><a href="structflow_1_1cfg_1_1Final__validator__func.html">flow::cfg::Final_validator_func</a></div><div class="ttdoc">Utility/traits type to concisely work with final-validation functions when calling methods like Confi...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l00040">cfg_manager.hpp:41</a></div></div>
<div class="ttc" id="astructflow_1_1cfg_1_1Final__validator__func_html_aa930ac2fbe3ad6abc07994984f875c81"><div class="ttname"><a href="structflow_1_1cfg_1_1Final__validator__func.html#aa930ac2fbe3ad6abc07994984f875c81">flow::cfg::Final_validator_func::null</a></div><div class="ttdeci">static Type null()</div><div class="ttdoc">Returns a final-validator function that simply always returns Final_validator_outcome::S_ACCEPT.</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l02712">cfg_manager.hpp:2712</a></div></div>
<div class="ttc" id="astructflow_1_1cfg_1_1Null__value__set_html"><div class="ttname"><a href="structflow_1_1cfg_1_1Null__value__set.html">flow::cfg::Null_value_set</a></div><div class="ttdoc">Empty struct suitable as a *_value_set template arg for Config_manager, when a slot requires a Value_...</div><div class="ttdef"><b>Definition:</b> <a href="cfg__manager_8hpp_source.html#l00071">cfg_manager.hpp:73</a></div></div>
<div class="ttc" id="autil_2util_8hpp_html"><div class="ttname"><a href="util_2util_8hpp.html">util.hpp</a></div></div>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Fri Mar 28 2025 22:55:35 for Flow by&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.4
</small></address>
</body>
</html>
